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PREFACE 



This manual describes the SCOPE 3.4.4 Operating System for the CDC® CYBER 70 Models 72, 73, and 74 
and CDC 6000 Series computers. It is written for system programmers who perform system evaluation or 
program modification: 

Part I describes the system interface with the central processor and peripheral processors, files and file tables, 
input/output, job processing, permanent file manipulation, and various system utilities. Part II contains system 
tables and file formats divided into four general areas: central memory, job control point, disk and files, and 
extended core storage. In general, the central memory tables, extended core storage tables, disk tables and file 
formats are of interest only to system programmers. The job control point tables are of interest to all users 
of the product set. Job control point tables can be used by central processor programs running at any control 
point. The tables in part II serve as reference material for those familiar with the system and its product set. 
More detailed information is available in the various reference manuals and internal maintenance specifications. 



RELATED PUBLICATIONS 

The following manuals contain additional information about the SCOPE 3.4 operating system that may be 
useful to a systems programmer. 

Control Data Publication Publication Number 

SCOPE Version 3.4 Installation Handbook 60307400 

SCOPE Version 3.4 Reference Manual 60307200 

SCOPE Version 3.4 Operator's Guide 60327300 

SCOPE Version 3.4 Diagnostic Handbook 60386400 

SCOPE Version 3.4 Enhanced Station Operator's Reference Manual 60343800 

CYBER Common Utilities Reference Manual 60493300 

UPDATE Reference Manual 60342500 i 

CYBER Record Manager Reference Manual 60307300 

CYBER LOADER Reference Manual 60344200 

The SCOPE 3.4 Internal Maintenance Specifications are available on listable magnetic tape. 

Unless otherwise indicated, bit and byte numbers are given in decimal; word addresses, field and table lengths, 
and block and page sizes are given in octal. Unless reserved for a specific purpose or group, all currently 
unused fields, names, codes, and so on are reserved for future development. 



60306500 L 



DISCLAIMER 

This product is intended for use only as described in this document. Control Data cannot be responsible for 
the proper functioning of undescribed features or parameters. 
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ECS partitioning restructure 

844 spare drive support 

Segmented CMR for ECS systems 

JANUS support of 580 line printers 

Support of symmetric links between CYBER 70/Models 72, 73, and 74 

844 shared controller/drive support 

Support of shared 844 devices in a dual-mainframe system 

Implementation of public as well as private device sets 

System Control Point 

SCOPE/INTERCOM Front End 

New features added with this revision to SCOPE 34.4 include: 
844 factory format support 
Restructure of the handling of RMS stack requests 
Enhancements to job management and system control point capabilities 
On*line Maintenance Software 
Modification of 881 disk pack reformatting utility 
INTERCOM Restart 
Enhanced Station performance improvement 

Numeric values given in this document, unless otherwise indicated, are assumed to be as follows: 



Bit numbers 


Decimal 


Byte numbers 


Decimal 


Word addresses 


Octal 


Field/table lengths 


Octal 


Block/page sizes 


Octal 



This product is intended for use only as described in this document. CONTROL DATA 
cannot be responsible for the proper functioning of undescribed features or undefined 
parameters. 
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SCOPE 3.4 INTRODUCTION 



The operating system for CONTROL DATA® CYBER 70/Models 72, 73 and 74, and the 6000 Series computers 
provides Supervisory Control of Program Execution (SCOPE). The SCOPE operating system controls the use of 
CONTROL DATA CYBER 70/Models 72, 73 and 74, and 6000 Series computer hardware. Therefore, SCOPE is in 
control of the computer. SCOPE accepts input in the form of jobs submitted by users and processes them as directed 
by control cards accompanying each job as well as by keyboard commands input by the operator. 

Efficient processing of user's jobs is the prime objective of the operating system. This section describes the 
inherent hardware characteristics, the basic software elements, and how they work together to accomplish 
the prime objective. 

HARDWARE CHARACTERISTICS 

SCOPE uses peripheral processor units (PP) for system and input/output tasks and a central processor unit 
(CPU) to execute user and system jobs. Central memory (CM) contains user programs; system software 
areas are located at the upper and lower ends of central memory. An extended core storage (ECS) unit may 
be used to contain SCOPE libraries and other items (such as file buffers for RMS and swap files) which 
may not be contained in CM or on other mass storage devices. 

CENTRAL PROCESSOR 

The CPU is designed to perform tasks of a computational nature; it has no input/output capability. It 
communicates with other system components through the central memory. Under SCOPE, the CPU is used 
almost exclusively for program compilations, assemblies, and executions. The CPU makes system requests 
through a CPU request register located at the reference address plus one (RA+ 1) of the current program 
in execution. 

PERIPHERAL PROCESSORS 

The peripheral processors, of which there may be up to 20 (identified as PP0, PP1, . . . PPn) are identi- 
cal; they perform many tasks for requesting programs in central memory. 

A PP can be assigned to control, input/output, job scheduling, control card interpreting, system housekeep- 
ing and other tasks as required. Tasks are assigned one at a time to each PP by the system monitor (MTR). 
When an assigned task is completed, the PP signals the system. MTR waits for this signal before assigning 
another task to the PP. 

Each PP is assigned a block of eight words in the system area of central memory through which communi- 
cations with the system are conducted. Each block contains an input register, an output register, and a 
message buffer. Peripheral processors are discussed in section 3. 
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CENTRAL MEMORY 



Central memory words are 60 bits long; each has five 12-bit PP memory words, called bytes. Each 12-bit 
byte in a CM word is numbered through 4. from left to right: 



59 



48 47 



36 35 



24 23 



1211 



byteO 



byte t 



byt«2 



byte 3 



byt«4 



One or more user programs may be in some state of execution concurrently under SCOPE. These programs 
are stored in central memory in an assigned user area; a set of system components necessary for the 
operation of the system is also stored in. central memory, forming the central memory resident (CMR) and 
the record block table (RBT) areas. Central memory is accessible by all PPU's and CPU's and forms the 
communications link between all processor units in the computer system. 

Central memory resident (CMR) contains system communications areas, system tables, CPU resident rou- 
tines, the library directory, and information about each job currently in execution. The CMR is discussed in 
section 2 of this manual; the RBT is discussed in section 4. 

EXTENDED CORE STORAGE 

FEATURES 

Under SCOPE 3.4. Extended Core Storage (ECS) is divided into three areas: the System Area, the Dynamic 
Area, and the Direct Access area. They function as follows: 



System Area 
Dynamic Area 

Direct Access Area 



Contains system pointers and tables required by ECS software 

Paged area; contains buffers, library programs, swap files and other files 
assigned to ECS 

Assigned to user as result of job card request; used and managed by 
requestor. Also contains the ECS segment library in ECS control point 
zero field length. 



Such division of ECS allows the following features to be provided: 

I/O buffering through ECS (via CM buffers or Distributive Data Path) 

Library residence in ECS 

Job swapping to/from ECS by the Integrated Scheduler 

Compatibility with BNL-ECS 

Segmentation of system CP code 
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ECS PAGING 

The basic element of ECS paging is a PRU made up of 100B CM words. A group of eight consecutive PRUs 
(1000B CM words) forms a page. I/O buffering through ECS is made possible by the paging of ECS. A dead- 
start installation parameter defines the buffer size. IP.EBUF determines the default buffer size for deadstart 
processing and has a default value of 16 decimal pages. 

ECS paging provides the following advantages: 

More efficient usage of ECS through dynamic allocation/deallocation of space 

Availability of ECS to more users by allowing the use of an "over-commitment" algorithm for ECS 



SOFTWARE ELEMENTS 

Two elements are basic to the SCOPE operating system: files and control points. 

FILES 

A file is an organized collection of data known to the system by a given name. Data is organized in one or 
more logical records and terminated by an end-of-file indicator. Under the SCOPE operating system, the 
jobs it processes and all intermediate and final results are contained in files or parts of files. Files are 
discussed in section 4. 

CONTROL POINTS 

The system can control execution of several jobs at one time. When placed into CM before execution, each 
job is assigned a value which is the control point number and the index to a control point. Jobs at control 
points are assigned to a processor for execution. Each control point has a control point area in the CMR 
which holds all information necessary to process the assigned job. The control point concept is discussed in 
section 2. 

SCOPE ORGANIZATION 

The SCOPE operating system consists of PP programs, CP programs, macro definitions, and symbol defini- 
tions. The entire system is contained on program library files produced by the library maintenance program 
UPDATE. Programs in the library file are in source language form. Installation options are provided to 
permit flexible selection of system features during the assembly and creation of a deadstart file on tape. 

A system monitor is in complete supervisory control of the hardware system. The system monitor is made up 
of PP overlay OV.MTR, which operates in PPO, and CPMTR, which in a disk system is assembled as part of 
the central memory resident or in an ECS system consists of a number of separate segments. 
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SYSTEM LOADING 

To load the operating system into u CYBER 70 or 6000 series computer, the deadstart tape is mounted on a 
device and a small bootstrap loader program is set up on the hardware deadstart panel switches. When the 
deadstart button or the operator's console is activated, the bootstrap program is transferred to and executed 
in PPO. The bootstrap loader reads the PPO save program (CEA) from the first record on the deadstart file, 
executes it, then reads the deadstart control program (CED) from the next record into PPO and sets it into 
operation. CHD determines the type of deadstart to be performed, then loads the required routines into all 
PPs involved in the deadstart process. The routines include a display routine in PPO and I/O routines in 
PPl and PP2. CMR is read from the deadstart file into CM, and a display shows all deadstart functions 
and the options that may be selected. 

The functions include: 

Type of deadstart to be performed 

Level of system to be used 

Level of processing to be performed on rotating mass storage (RMS) device labels 

Status of permanent tiles to be used 

Restriction of permanent tiles to disk pack devices (854 and 841 only) 

Changes to be made to equipment configuration of the sysieirfi 

Level of initialization of ECS 

Pre-allocation of RMS devices for customer engineering diagnostic programs 

The operator may select specific options or take the default option for each function. 

When processing of deadstart options is completed, control is passed to MTR and DSD. The system 
deadstart tape will be rewound to its load point, and it will not be referenced again during operation unless 
another deadstart is necessary. The tape may be removed and the tape unit cleared for use in other 
operations. At this point the system is ready to process jobs (see section 7). 
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Upon completion of system loading, the computer contains the following: 

1. Initial system libraries, stored on one or more mass storage devices. Programs can be loaded from any 
system library into PPs or CM as needed. 

2. The central memory resident (CMR), loaded into the low end of central memory. A set of tables in 
CMR contain information about the system. Some of the tables are used by the system PP programs 
to communicate with each other. A record block table (RBT) is built in the upper end of CM. 

3. Also, some programs in the system are stored in central memory in an area immediately above the 
CMR. Such programs can be loaded into PPs or into other CM areas much faster than they can be 
loaded from the system storage device. Storage space in CM is costly and space used to store library 
programs cannot be used to run user programs; therefore, only the most necessary and frequently used 
library programs are stored there. For the same reason, CMR is kept as small as possible. 

4. The system monitor program (MTR in PPO and CPMTR in CMR) remains in overall control of the 
system. It controls allocation of system physical resources (CM, ECS, channels, equipments, PPs and 
CPUs). It handles all communications between user programs and the system and coordinates activities 
of the other PPUs. 

5. PP1 contains the operator console display driver program, DSD. DSD provides a communication path 
between system and operator. Current system status is displayed by DSD on the two screens in the 
operator console. The operator can control system operation by typing commands on the console 
keyboard. 

6. Each remaining PP contains pointers to a PP communications area, an area in CMR used for communi- 
cations between each PP and MTR, and a PP resident program loaded into each PP. The resident is 
responsible for reading the input register and loading PP overlay programs into its PP as assigned, and 
for providing communication between the overlays and MTR. 
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SCOPE SYSTEM TAPE 

The released SCOPE 3.4 system (deadstart) tape consists of: 



Name 

CEA 

CE Diagnostics 

CED 

TDR 

MDR 

D 

DMT 

DTS 

CMR 

COM 

IRP 

5CP 

5CQ 

5CS 

5CT 

5CV 

5CW 

5CY 

P 

OSY 

OMT 

IRCP 

STL 

MTR 



Description 

PPO save program 

See next page 

Deadstart PP control program - resides in PPO 

Read driver for 60x, 65x tape drives — in PP1 

Read driver for 66x tape drives - in PP1 and PP3 

Deadstart dump control program, handles options - in PPO 

Dump magnetic tape driver for 60x, 65x tape drives - in PPO 

Dump magnetic tape driver for 66x tape drives - in PPO 

Central memory resident (up to 8 copies) 

Deadstart option matrix generator - in PP2 

Deadstart RMS driver control program - in PP2 

Deadstart 6603-1 driver 

Deadstart 6638 driver 

Deadstart 854 driver 

Deadstart 6603-11 driver 

Deadstart 821 driver 

Deadstart 841 driver 

Deadstart 844 disk subsystem driver 

Pre-address 6603-11 program 

844 Buffer controlware 

MTS controlware 

Deadstart main central processor program 

Deadstart system initiation program (PP resident) 

System monitor program 
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DSD Display control program 

1 Library name table 
PP name table 
PP programs — the first must be stack processor's segment 
Entry point table 
External reference list 
System J External reference table 

Libraries I Program number table 
Program name table 
CP/PP routines 
Any installation may expand the above records in two ways: 

1. By installing CE Diagnostics. The deadstart diagnostic sequencer, CES, will be placed after CEA, 
followed by diagnostic routines selected for the site (CU1, ALS, FST, etc.), followed by routine CED. 

2. By placing up to seven additional CMR records on the system tape for different equipment 
configuration. 
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CENTRAL PROCESSOR AND SCOPE 



CM ORGANIZATION 

The allocation of central memory is illustrated below: 



Machine Fl_ 



RBT 



Assigned to 
Control Points 



CM Library 



CMR 



High Core 



Low Core 



Low core is allocated to the central memory resident portion of SCOPE, executable system programs, and 
INTERCOM buffers. The length of the INTERCOM buffers area varies dynamically when INTERCOM is 
running. High core is allocated to the record block table (RBT)? its length varies dynamically with the load 
of the system. The remaining area can be assigned to control points. 

CONTROL POINT CONCEPT 

Blocks of central memory storage not allocated for system use are ordered by control point number and 
assigned to jobs. Each control point number has a corresponding table in CMR called the control point 
area. A control point is not a physical entity, but rather a concept used to facilitate bookkeeping. The control 
point number and the control point area, however, are physical quantities that do appear in the system. 

Under SCOPE 3.4, any number of control points up to 15 are possible. In the released system, the default 
value of N.CP is 1 5 decimal. In an installation with n control points for user jobs they are numbered from 
1 to n. Only one job can be assigned to a control point at any one time. Once a job is assigned to a control 
point, system resources such as central memory, ECS, channels, equipments and processors may be assigned 
to the control point for use by the job. 

Storage assigned to a single control point is contiguous; storage for all control points is -not necessarily 
contiguous. The core storage block assigned to the job at control point 2 is higher than the block for the job 
at control point I, and storage for control point 3 is always higher than that for control point 2, and so on. 



60306500 C 



2-1 



In the following figure, no storage is assigned to control points 3 and 5; unassigned storage appears 
between assigned storage. 



Machine FL 


RBT 




CP7 
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CP1 




CM Library 





CMR 



High Core 

i, 



Low Core 



In addition to the n control points used for running jobs, two pseudo control points, numbered zero and 
n+ 1, are used by the system. 

Control point zero is used to identify system resources not allocated to a job at a control point; they are 
unallocated or allocated to the system. If an equipment is assigned to a control point, that number is 
entered into the system table entry for that equipment. 

If not assigned to a job, the equipment is assigned to control point zero and is available to be assigned to a 
job. All active system files are attached to control point zero. They include the system file, any job files 
that have been read in and are waiting for scheduling, and all output files waiting to be processed by JANUS 
and remote batch processors. Control point n+ 1 is used by monitor (MTR) when it runs a central processor 
(CP) system program. For example, if MTR needs to move the storage assigned to a control point, it asks 
CPMTR to initiate the CP storage move program in central memory resident. Since the CP storage move 
program is not associated with any specific job running at a control point, it is assigned to control point n+1. 
There is no control point area in CMR for control point n+1. 
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JOB DESCRIPTION NUMBER 

During the course of execution, a job might not remain continuously at the same control point. It is possible 
for the job to be swapped out while it is only partially executed. When a job is swapped out it is not 
associated with a control point. When a job is swapped back in it is probably associated with a control 
point other than the control point during its original assignment. 

During the time a job is swapped out, the only table in CMR that contains information about the job is the 
Job Descriptor Table (JDT). When a job is initialized at a control point it is also assigned to an entry in the 
JDT. The job descriptor number is constant and is used to identify the job during its entire execution. 

In order to clarify the difference between job descriptor number and control point number, JDT numbers 
start at n + 1 where n is the number of control points. 

STORAGE MOVES 

Since jobs come and go as they finish processing and new jobs begin, or as jobs are swapped in and out. 
CM storage must be reallocated and jobs must be moved. If a job at a control point requests additional 
storage, it may be necessary to move jobs to obtain the required storage. MTR keeps a tally of unassigned 
CM in a CMR word T.UAS. Storage associated with each control point is of two types, either of which may 
have a zero value. 

Allocated storage is defined by the reference address (RA) and field length (FL) of the control 
point. 

Unallocated storage (UAS) lies between the allocated portions of two consecutive control points. 
This area is associated with the lower of the two control points, but it may be transferred to 
neighboring control points by moving any intervening allocated storage. 

A request for a reduced field length merely transfers storage to UAS (no storage moved). A request for an 
increased field length, when the total already associated with the control point is adequate, will result in a 
transfer of unallocated storage to allocated; no storage move will take place. 

If it is necessary to take unallocated storage from other control points to satisfy a request for increased field 
length, control points above and below the requesting control point will be a scanned. This scan locates the 
combination of unallocated storage blocks which will result in a move of the least amount of storage. 

In the diagram shown under Control Point Concept, if control point I needs more storage, it will be 
necessary to move control point 2. If control point 6 needs storage, sufficient unallocated storage may be 
available to make a control point move unnecessary. If, however, control point 7 needs additional storage, 
control points 4, 6 and 7 will be moved downward to provide the storage. Added storage always extends the 
field length upward. 
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STORAGE MOVE EXAMPLE: 

Control point 5 requests an FL of 300 (all values are increments of 100 octal). 

Before After 



Control 






Unallocated 








Point 


RA 


FL 


Storage (UAS) 


RA 


FL 


UAS 








142 








142 
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33 





142 


33 
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31 
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31 





3 


226 
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20 
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100 
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1176 


150 . 





1176 


150 





7 


1346 





430 


1346 





430 



If MTR takes the UAS from control point 7, the 150 units of central memory at control point 6 would 
have to be moved; however, taking UAS from 3 and 4 requires moving 120 units of central memory at 
control point 4 and 5. (20 units are moved from 4 to 3 and 100 units are moved from 5 and added on 
behind the 20 units moved to 3.) 



CP - SYSTEM COMMUNICATION 

A running CP program must communicate with the system in the following situations: 

1. When a CP program is loaded and executed as a result of a control card call, the system must place 
any parameters specified on the control card in an area where they can be read by the CP program. 

2. No CP instructions allow a CP program to perform input/output; therefore a CP must send a request 
to the system, to load a PP program to execute the input/output. 

3. When a CP program terminates, it must advise the system that it may process the next control card. 

Since a CP program cannot access memory locations outside its field length, any area reserved for communi- 
cation between a CP program and the system must be within the field length of the job. The first 10 IB 
locations of each job's field length are reserved for this purpose . The following 10B words are reserved for 
the loader table. The first program loaded into a user field length is always loaded at location RA+111B 
because the reserved words are RA+0 through RA+110B. 

The RA Communication Area is shown in Part II, Section 2. 
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The first word of a user field length (location RA+0) is reserved for use of hardware and software flags in 
event of error. Other locations in the first hundred octal words of a user field length store information 
needed for execution of system program. Monitor regularly scans location RA+1 which is presumed to con- 
tain a request from the central processor for monitor to summon a peripheral program. The form of the 
request is: 

59 41 39 C 



1 MINIMI IMIII II 

PP Program Name 


III II MM Ml II MM MM III II II M 1 INI II 

r Address of Parameters 



r Recall Bit 40 

Loader information is placed by the first of several loader routines in words RA + 64 through RA + 67. 
This information is used and modified as additional loader routines complete specific tasks. 

When parameters are encountered on a control card, they are placed in locations RA + 2 through RA + 63 
by 1AJ, which stores the total number of parameters in location RA + 64. When the routine or file indicated 
on the control card executes, it finds in these locations the information needed to direct execution. 

CP - PP COMMUNICATION 

If a user's program places a call for a PP program in RA+ I, CPMTR will pick up the RA+ 1 call, insert 
the control point number of the caller into bits 36 through 39 of the word, and clear bit 41. If the central 
exchange jump (CEJ) installation is available, the user's program should use it immediately after placing a 
call in RA+1. This will cause CPMTR to begin execution immediately. If CPMTR determines that the 
RA+ 1 call should be assigned to a PP it will pass the call on to MTR. 

When a PP is available, MTR will write the word into its PP input register, in CMR. Figure 3-2 shows 
the format of a PP input register for a transient program called from a CP program. The name, the auto- 
recall bit, and any parameters in bits zero through 35 appear in the input register exactly as they did in 
RA+ 1. Parameters are passed from a CP program to a PP program through this parameter field. 

For example, if the PP program CIO is called, CIO will find the relative address of the file environment 
table (FET) to be used in the operation by reading its input register. It can find the RA of the control point 
field length by reading the control point number from its input register, computing the address of the 
control point area, and reading the value of RA from the control point area. By adding the RA to the 
relative FET address, CIO obtains the absolute address of the start of the FET. CIO then reads the 
parameters for the I/O operation from the FET. In ECS systems, CPMTR traps all CIO calls and sends them to 
CPCIO, where the device type is checked. If the device is RMS or ECS, the request is processed; otherwise, the 
request is sent to CIO. 

MTR continually scans RA+ 1, in the event that the users program does not use the central exchange jump, 
or the instruction is not available. When a RA + 1 call is found MTR initiates CPMTR. Less CPU time is 
used by letting CPMTR process the call, than if MTR did it directly. 

Bit 59 of RA + 66 is used to communicate to the user program if the central exchange jump is available. If 
the hardware for this instruction is available the bit is set on. 



60306500 L 2-5 



PROGRAM RECALL 

The recall program status is provided in SCOPE to enable efficient use of the central processor and to 
capitalize on the multiprogramming capability of SCOPE. Often, a CP program must wait for an I/O 
operation to be completed before more computation can be performed. To eliminate the CPU time wasted 
if the CP program were placed in a loop to await I/O completion, a CP program can ask SCOPE to put the 
control point into recall status until a later time; and the CPU may be assigned to execute a program at 
some other control point. The job itself may be rolled out or swapped out, as necessary. 

Recall may be automatic or periodic. Auto-recall should be used when a program requests I/O or other 
system action and cannot proceed until the request is completed. SCOPE will not return control until the 
specific request has been satisfied. Periodic recall can be used when the program is waiting for any one of 
several requests to be completed. The program will be activated periodically, so that it can determine which 
request has been satisfied and whether or not it can proceed. 

PERIODIC RECALL 

To enter periodic recall, a CP program puts the characters RCL left-justified into RA+1. On encountering the RCL 
request, CPMTR examines the auto-recall bit (bit 40); if it set, the request is considered to be an auto-recall request. 
If it is not set, CPMTR checks bits 0-10 (decimal) for a delay count. If this delay count is not set, CPMTR specifies 
a default value for it. The delay count of the control point in periodic recall is examined regularly by the advance 
control point routine (ACP) of MTR. When the delay count expires, the control point loses its recall status; and the 
CPU is again assigned to execute the program at the control point. At this time, the CP program can check completion 
bit in the FET to see if the I/O is finished. If so, the CP program may proceed with computations. If I/O is not 
complete, the CP program will put itself back into recall. 

AUTOMATIC RECALL 

If a CP program makes a request in RA+ 1 and bit 40 of RA+ 1 is set to one, the control point will be put 
into automatic recall after the request has been initiated. Again, the CPU is assigned to another control 
point as in periodic recall. In this case, however, the program in recall will be restarted by MTR after the 
completion bit in the FET has been set. MTR, not the user, checks the completion bit in the FET. 

Recall and auto-recall are most often used while waiting for CIO to process an I/O request; however, any 
time a PP program is called from RA+1, with bit 40 of RA+ 1 set to one, the control point will be put into 
auto-recall. If bit 40 is set, bits zero through 17 of RA+1 must contain the address of a word in the 
program's field length called a reply word. When the PP has completed its function, it will set the comple- 
tion bit (low order bit) in the reply word. When the completion bit is set, MTR will restart the program. 

For a call to CIO, the reply word is the first word of an FET. For other programs the reply word need not 
be part of an FET. 

Some PP programs (DMP and MSG) set the completion bit only when they are called with auto-recall. 
Periodic recall cannot be used for these programs. 

A CP program can put itself into auto-recall without calling a PP program by putting RCL left justified in 
RA+1 and setting bit 40 of RA+ 1 to one. Bits zero through 17 of RA+ 1 must contain the address of a 
reply word. A program which has already initiated one or more I/O operations might go into auto-recall in 
this way, using the first word of the FET associated with one of the I/O operations as the reply word. 
Figure 2-1 shows the formats of RA+ 1 for: a normal CIO call; a request for periodic recall; a CIO call 
with auto-recall bit set; and an RCL call with auto-recall bit set. For periodic recall, a user must issue a 
normal CIO call followed by an RCL request. For auto-recall, only one request is required. 
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Normally. CP programs use auto-recall for convenience, bin only one request involving auto-recall can be 
processed at one time. For example, to initiate I/O action on -.evcral lile> at once, a user must employ the 
periodic recall technique. He will issue all the requests without recall (using a separate FET for each 
request): then go into periodic recall. Kaeh time the CP program is resumed by the system, it can check all 
the files lor completion and go back into periodic recall if any arc still incomplete. 

Periodic recall may be used also when a CP program can initiate an I/O request and then perform some 
computation. In some cases, the I/O would be completed before the computation: in others, the computa- 
tion would be done first. The user would go into recall only when computation was done, and then only if 
the I/O was still in process. 

Periodic recall should also be used, if possible, to continue processing while only part of the data buffer has 
been read or written by the I/O driver. Some of the I/O drivers coordinate with MTR so that a program in 
periodic recall is restarted after one or two PRU's have been processed. 



CIO CALL 



59 



42 40 



17 



CIO 







Count for 
Positioning Requests 


FET Address 



DISPLAY CODE (CIO = 031117q) 

CIO CALL WITH AUTO-RECALL 
59 42 40 17 



CIO 




1 


Count for 
Positioning Requests 


FET Address 



REQUEST FOR PERIODIC RECALL 



59 



42 40 



RCL 






59 



REQUEST FOR AUTO-RECALL 
42 40 17 



RCL 




1 




Pseudo 
FET Address 



Figure 2-1 . Call Formats 
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CENTRAL MEMORY RESIDENT 

The low end of core storage is reserved for the central memory resident portion of SCOPE and the system 
library "portions which reside in central memory. CMR contains pointers, tables and programs. Its length is 
dependent upon several factors, including the number of peripheral processors and the number of control 
points, which determine the number of tables in CMR and the length of certain tables. Some CMR tables 
are optional and may appear only by installation parameter. Figure 2-2 illustrates a typical CMR. 



Pointers and Small Tables 
(Lower Table Area) 



200 



Control Point Area and System Exchange Packages 



PP Communications Area 



Large Tables 
(Upper Table Area) 



ECS Tables 



CM Resident Programs 
(or Segmented System CM Areas) 



Library Directory 



Figure 2-2. Typical CMR Assignments 
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SUMMARY OF CENTRAL MEMORY RESIDENT AREAS 

Lower Table Area Contains pointers to larger tables in the upper table area of CMR, along with various 
flags, constants, and installation option parameters. It includes accounting information, calendar and Julian 
dates, the system display label and other small tables. The lower table area occupies the first 200 words of 
central memory. 

Control Point Area Contains a 200-word area for each control point in the system. Each area contains the 
job name, exchange package, and other information related to the job running at that control point. The 
system exchange package is also contained in the same area. 

PP Communications Area Contains eight words for each peripheral processor in the system, through 
which they communicate with the system monitor and with each other. Each area contains the PP input 
and output registers and a 6-word message buffer. 

Upper Table Area Contains major tables pertinent to system and job operation. 

ECS Tables Area Contains buffers for transferring PP overlays and RMS files. 

CM Resident Program Area Contains four resident programs: 

CP.MTR Central Processor Monitor 

CP.SM Central Processor Storage Move 

CP.SPM Central Processor Stack Processor Manager 

CP.SCH Central Processor Memory Manager (Scheduler) 

In a segmented system, the CM resident program area is overlaid by the ECS system resident and by the CP 
code overlay segments. 

Library Directory Contains tables related to the system libraries, including library name table, PP program 
name table and the CM resident library programs. 



60306500 L 2-9 



CENTRAL MEMORY RESIDENT 



o 

100 
154 
200 



T.CST 

T.CPA n 

T.XPIDLA 

T.PPC1 

T.EST 

T.FNT 



T.ITABL 

T.DAT 

T.RMSBUF 

T.STG 

T.APF 

T.RQS 

T.RST 

T.RBR 

T.RBRBIT 

T.DST 

T.TRB 

T.SEQ 

T.INS 

T.MST 

T.DDT 

T.VRNBUF 

T.TAPES 

T.MAI L 

T.IDT 

T.DFB 

T.PJT 

T.SSCT 

T.SCHPT 

T.SCHJCA 

T.SCHJDT 

T.BCFAP 



Pointers 

Channel Status Table 

PP Status Words 

Control Point Areas 

System Exchange Packages 

PP Communication Areas 

Equipment Status Table 

File Name Table 

CIO-CPCIO Special FNTs 

Permanent File FNTs 

INTERCOM Table 

Device Activity Table 

RMS Buffer 

Tape Staging Table 

Attached Permanent File Table 

Request Stack 

Request Scheduling Table (RMS) 

Record Block Reservation Table (Headers) 

RBR Bit Table 

Device Status Table 

Trace Buffer 

Sequencer Table 

Installation Area 

Mounted Set Table 

Dismounted Device Table 

VSN Buffer 

Tapes Table 

Scheduler Mailbox Bufier 

Logical ID Table 

Dayfile Buffers 

Parameter Storage for Delayed PP Jobs 

Subsystem Control Table 

(Optional) Scheduler Statistics 

Scheduler Job Control Area 

Scheduler Job Descriptor Table 

CPMTR CEFAP Buffer 



PP Resident Overlay Save Buffer 

Breakpoint Table (ECS System) 

Area Table (ECS System) 

Entry Table (ECS System) 

Device Overflow Table 

CM Resident Programs (Disk System) 

Segmented System Areas (ECS System) 

Empty Page Stack 

ECS Parameters 

Library Directory 

INTERCOM Pointer Area 

INTERCOM Buffers and User Tables 



(Job control point user field length) 
T.RBT RBT Chains 



T.PPOVL 
T.BRKPT 
T.AREA 
T. ENTRY 
T.DOT 



T.EPAGE 

T.ECSPRM 

T.LIB 



'Table Must Begin Before 10000B 
$Table Must Begin Before 20000B 
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SUMMARY OF TABLES IN UPPER TABLE AREA 

Equipment Status Table One entry for each device in the system configuration. Non-allocatable devices 
can be assigned to one control point at a time; allocatable devices may be attached to many control points 
simultaneously. 

File Name Table Contains an entry for each file in the system, created when the file is created. Several 
entries are preset and remain in the system for duration; these entries are for the system library (deadstart) 
file, the system and control point dayfiles, and the hardware error file. 

INTERCOM Table Provides multiplexer and port definition information for INTERCOM program use. 
Assembled only by installation parameter HUNTCM. 

Device Activity Table Four-word entry for each RMS device in system. Each entry provides dynamic 
information related to current activity of the RMS device. 

Rotating Mass Storage Buffer Holds a message to be flashed on the bottom line of the B display. The 
message is used to report an error on an RMS device and ask the operator to idle down the device. 

Tape Staging Table Defines availability, assignment, and demand for tape devices. 

Attached Permanent File Table Provides information for the permanent file manager and job use. Con- 
trol and status information entries are created when a permanent file is cataloged initially or attached to a 
qualified CP program. 

Request Stack Requests for data transfers, device positioning, or logical file operations. Each allocatable 
device in system has at least one 3-word entry in this table when a request for its use is active. 

Record Block Reservation Table Provides continuous information as to assignment/availability of record 
blocks in which file data is recorded on allocatable devices. Strings of bits in the RBRBIT table denote 
current status of record blocks in each device. 

Device Status Table Directly related to the request stack; contains a 2-word entry for each allocatable device 
in the system, plus an additional pseudo-entry for unassigned file processing. 

Tapes Table Contains one entry (10B words/entry) for each tape unit defined. 

Device Pool Table Contains a 10-word area for each RMS device. Used by associated ISPs to pass their 
internal pool area to each other. 

Sequencer Table Contains 30-word entry for each preallocated RMS device for use for CE diagnostic programs. 

Installation Table Reserved for specific needs of installation. Tables are generated in the area only by installation. 

Mounted Set Table One entry for each mounted device set, including the public sets. 

Dismountable Device Set Entries for each RMS device plus entries for each queueing devices needed by jobs. 
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ID Table Contains Host ID, Logical IDs, and Physical (link) IDs. The ID table may be zero-length. 

Mailbox Used for communications between system and swapped out jobs. 

Dayfile Buffer Area Contains dayfile buffers and file environment table entries of the system dayfile, the 
control point dayfiles, and the hardware error file. The control point zero buffer is at the end of this area. 

Peripheral Job Table Contains parameters saved for delayed PP jobs. 

Subsystem Control Table Contains names of defined subsystems. 

Scheduler Performance Table Optional table used to collect execution data to study the efficiency of the 
integrated scheduler. Created by installation parameter IP.SPT set to 1. 

Job Control Area Contains entries pertinent to the scheduling of jobs by class and queue priorities. 

Job Descriptor Table Contains linked entries for each class of job. Entries describe job requirements, current 
status, accumulated use time of system components, etc. See Job Processing, Chapter 7. 

Breakpoint Table Contains the breakpoint code exchange package, the breakpoint wait loop, flags and data 
used by DSD, and the breakpoint entries. It is used by DSD and breakpoint processing. 

Area Table Eight-word buffer that receives the ECS area table from a segmented system. It describes the 
system ECS and CM structure. 

Entry Table Contains the date-time stamp for this CMR, the associated segment library name, and a list of 
the entry points defined in the tables with their addresses. 

Library Directory Falls at the end of the CMR upper table area following the CM resident programs and 
ECS tables; and is of variable length. It contains 2-word entries in the program name table section and 1-word 
entries in the entry point table. The directory length may expand or contract as programs are added and 
deleted or as program residence is changed. 

CP Resident Programs (in a disk system) 

Symbol Name/Function 

CP.MTR Central processor monitor 

CP.SM Central memory storage move 

CP.SPM Stack processor manager 

CP.SCH Memory manager scheduler 
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CMR SEGMENTATION FOR ECS SYSTEMS 

CMR segmentation is implemented for installations with ECS. A segmented system is intended to have most of 
its CP code ECS resident. Sections of code (segments) are loaded as needed in CM overlay areas. A segmented 
system is started from an ECS system image by a bootstrap monitor function which overlays an existing system 
(disk or ECS) with a new system. The ECS system image for this new system must have been created in a 
previous step using the utility program LDCMR (see section 10). 

CORE LAYOUT 

For an ECS system, the equivalent of a disk system's system resident programs section in CMR is a number 
of specialized areas as follows: 



Tables. Resident Cod* 
(Idle Program, ECS Bootstrap, Breakpoint) 



Monitor Mode Return Stack 



Utar Mode Return Sock 



Monitor Mode Trace Buffer 



User Mode Trace Buffer 



ECS System Resident 
(Includes Segment Linkage) 



CMR Upper 
Table Area 



Monitor Mode Overlay Area 



Segmented 
System Areas 
(ECS System) 



User Mode Overlay Area 



Segment Table 



Library Directory 



Library 
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These areas are set up by the initialization segment IN1T, loaded by the bootstrap in the monitor mode overlay 
area. The position of the library directory is adjusted if necessary by LDCMR. The ECS system resident con- 
tains the segment linkage program which loads new segments and passes control to them, the ECS parity error 
recovery routine, and some heavily used code (CPMTR start, CPMTR return to user). The trace buffer and 
return stacks are used by segment linkage. 

The Area table completely describes an ECS system. It is read in from the ECS image of a segmented system 
by the bootstrap monitor function. 

The Entry table contains the entry points for tables in CMR which are not directly accessible by a text symbol 
of the T. type. This table is used by the utility LDCMR to load the ECS system and read the date-time stamp. 

The Breakpoint table is initially empty. The breakpoint (N) display and commands allow breakpoints (tem- 
porary halts) to be set and released in the operating system during system execution. CM, ECS, and the oper- 
ating system exchange package can be observed while the operating system is at a breakpoint. 

The Area table, the Entry table, and the Breakpoint table are detailed in part II, section 1 . 

SEGMENT LOADING 

SEGMENT LINKAGE 

Linkage is done through the GOTO (GOTOTAB), CALL, and RETURN macros. These macros can be used 
only in a segment defined through the SEGDEF and ENDSEG macros. 

GOTO EPTNAME 

transfers control to the entry point EPTNAME. 

GOTO TABLEJfcegister 

TABLE GOTOTAB EPTNAM2 

GOTOTAB EPTNAM2 

transfers control to the entry point referenced in a GOTOTAB macro in the position indexed by register 
in TABLE. 

RETURN 

returns to the last address and segment saved by a CALL. The previous address and segment saved will 
be used by the next RETURN. 

SEGMENT DEFINITION 

SEGDEF SEGMENT,mode,CM 

must be called immediately after the segment 1DENT (first group). 
SEGMENT is the segment name. 
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Mode if USER indicates user mode segment, otherwise monitor mode is assumed. 
CM indicates the segment must be CM resident. 

ENDSEG 

must be called immediately before the segment END. 

The name of the segment also can be the name of an entry point in the segment, but not of a tag. If it is 
not an entry point, the ENDSEG macro will define an entry point by that name referencing the second word 
of the segment. 

The SEGDEF macro generates a sement header word with the tag . . . REUSE. 

Header format after processing by LDCMR: 

59 17 o 



Segment Name 


Index in 
Segment Table 



All segments must be reusable serially, otherwise to prevent reuse, they must zero their header word prior to 
relinquishing control. 



PARAMETER WORD 

Linkage is done through a parameter word generated by the linkage macros and filled in by LDCMR. For a 
GOTO or a CALL, Al is set to the address of the proper parameter word and a jump is made to one of the 
linkage processor entry points. 

Parameter word format: 



59 



47 



29 



17 



Current 
Segment Index 


Parameter Word 
Address 


Next 
Segment Index 


Entry Point 
Address 



The addresses are absolute. The indexes are in the segment table. The parameter word is transformed into a 
return descriptor on a CALL by shifting it 30 positions and adding 1; it is stored in the proper return stack. 
A RETURN loads the last stored descriptor and performs a GOTO on it. If trace buffers are defined (see 
section 10 - LDCMR), all parameter words processed are stored in the trace buffer for the current mode. 
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Return stack format: 



Underflow Trap Address 



Parameter Words 



Next Free Entry 



Pointer to Next Free Entry 



Ascending Address 



Trace buffer format: 



Parameter Word 



Parameter Word 



Parameter Word 



Pointer to Next Entry 



Ascending Address 



Segment loading is done by using the segment descriptor in the second word of the segment table entry for 
the segment. The address of the segment table entry for a segment is: 

Segment table base address + 2 x index 

The Segment table is detailed in part II, section 1. 
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ECS SYSTEM IMAGE 

The system is written to the ECS direct access area as an extension of control point zero ECS field length. 
Two systems, named the old system (lower system) and the new system (upper system), can coexist in ECS. 
LDCMR creates ECS system images of the following form: 



Old System Area Table 



ECS System Resident 



1? 



Segments 



Segment Table 



New System Area Table 



,f 



EGS System Resident 



t 



ECS 
Direct 
Access 
Area 



Segments 



:t 



Segment Table 



,t 



* 



/ 



f If a terminator replaces the new system area table, the new system sections do not appear. 

The operating system requires approximately 20K of ECS in the direct access area. For example, if 40K is to 
be available for user direct access, 60K must be allocated to the direct access partition. If LDCMR is to be 
used after deadstart, the direct access area must be large enough to contain two operating system CP code 
versions - approximately 40K, minimum. 
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ECS ERROR RECOVERY 



Segments are protected against ECS errors in transmission or storage. An auto-corrective hamming code is 
applied to them to get correction vectors. The correction vectors and two checksums are placed at the end of 
the segment as shown: 



Segment Code 



Binary Checksum 



Arithmetic Checksum 



Correction Vectors 



Segment 



The code is capable of correcting a single bit error every four words. Vectors correct each four words, and a 
6-bit secondary correction vector makes vector words self correcting: 



59 



53 



47 



39 



31 



23 



15 





scv 


Vector 


Vector 


Vector 


Vector 


Vector 


Vector 



Errors are corrected only if they are detected by the ECS parity error mechanism. Detected errors are recorded 
in a error directory, then displayed in the dayfile (by a call to CEM, function 10). Error directory entries for 
a segment are linked to that segment's segment table entry. When an ECS error is encountered on a segment 
that has error directory entries, a first correction attempt uses the information in these entries. If this fails, 
the error entries are released and the full correction process is re-applied. The test of a successful recovery is 
the comparision of the existing checksums with the checksums for the recovered segment. The system is killed 
if a segment cannot be satisfactorily recovered. A recovered segment is written back to ECS, as it is possible 
the ECS error is transient. 



Error directory entry format: 
59 48 



T = 



41 



17 





T 


Bit 
Position 


ECS Address 


Link 



Bit dropped 



T= 1 



Bit picked 
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SYSTEM CONTROL POINT 

A system control point provides a centralized location for a module or group of modules, allowing them to per- 
form functions for one or more jobs at other control points. This facility provides overall reduction of central 
memory usage. Instead of several jobs having duplicate copies of these specially privileged modules in their field 
lengths, only one set of these modules needs to occupy central memory. This feature also improves coordina- 
tion of control and access. 

A module or group of modules which performs a specific set of functions is known as a subsystem. A subsystem 
executes at a system control point and has the ability to make privileged requests (reserved by subsystems) in 
addition to any requests which a standard control point is allowed. Each subsystem has a unique four digit 
ordinal by which it is referenced. Typical subsystems are a data base management system or Record Manager. 

A system control point (SCP) is any control point occupied by one of the subsystems. SCP may be used to 
describe both the control point and the subsystem at the control point. 

A user control point (UCP) is any job or module at a control point which makes a request to a system control 
point. A UCP may be a batch job, INTERCOM job, multi-user job, or another SCP. 



MANAGING SUBSYSTEM RESOURCES 

A subsystem at a control point may receive requests irregularly, leaving it idle for long periods. Since a system 
control point cannot be swapped out, some other action must be taken to reduce its memory requirement while 
it is idle. 

The idle subsystem should be organized so that it can reduce its field length to two or three hundred words. It 
should specify a half second periodic recall by using RCL with a 3777B delay period indicated by bits 10-0. The 
subsystem will then be started immediately when it receives a call. 

When a call is received, the following steps must be taken: 

1 . Issue a MEM call to acquire the field length necessary to process the requested function. 

2. Acknowledge the request by resetting RA.SSC. 

3. Load the subsystem overlay(s) required to process the request. 

4. Process the request. 

It is essential that the above steps be taken in the order specified. If steps 1 and 2 are taken out of sequence, a 
memory deadlock could occur; if the request is acknowledged before the memory is requested for the SCP, it is 
possible for a second SCP to make a request and have it successfully passed to the SCP. Both SCPs would then 
have outstanding SSC calls, preventing both from being swapped out. If the sum of the field lengths of the two 
UCPs and the required field length of the SCP is greater than what is available, the system will be deadlocked. If 
this occurs, one of the UCPs must be dropped to resolve the conflict. 
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CALLSS MACRO 

The CALLSS macro is issued by a UCP to request a particular function from a subsystem. A UCP may 
call more than one subsystem, either serially or in parallel. Also a UCP may make more than one call to 
an individual subsystem. The contents of registers XI, X2, Al, and A6 are destroyed during execution 
of the macro. These registers should not be used as parameters. The format of the macro is: 

label CALLSS ssid,addr,recall 

label is an optional statement label. 

ssid is a' required subsystem code. (This parameter may be a register name.) 

addr is the address of the parameter block for this request. This parameter is required and must 

be nonzero. (The parameter may be a register name.) If the address is outside the UCP 
field length the UCP will be aborted. 

recall if non-blank, the request will be made with automatic recall. (Processing at the UCP will 

be suspended until completion of the request.) 

PARAMETER BLOCK 

The parameter block pointed to by the addr parameter of the CALLSS macro is used by the UCP to pass param- 
eter information to the SCP. The parameter block must be at least one word long. 

The first word of the parameter block is used for calling and status information. The second and subsequent 
words of the parameter block are used for data which is passed to the SCP by the operating system. The format 
of the first word is: 



59 


35 


23 


17 


13 


11 





Reserved for System 


Reserved for 
Installation 


WC 


Res. 

for 

CDC 


R 

T 


ES (Error 
Status) 


C 



The fields of the first word are defined as follows : 

C This bit indicates whether or not the current request has been completed. If it has been completed, 
the operating system sets the bit to 1 ; otherwise it will remain set to zero. The user program must 
set this bit to zero prior to executing the CALLSS macro. 

ES The operating system sets this field to indicate the presence of an error or unavailable system con- 
dition. This field is not set (all zeros) if the RT field is zero. 

Bit 1 - subsystem currently running 

1 - subsystem not initiated 
Bit 2 - subsystem not busy 

1 - subsystem busy 
Bit 3 - subsystem defined 

1 - subsystem not defined 
Bits 4-5 reserved 
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Bits 6-11- error condition other than those described by bits 1, 2 and 3. Bits 6-11 can assume the 
following octal values: 

00 no other error 

01-17 reserved for system errors 

20-67 reserved for subsystem errors 

70-77 reserved for installation 

RT This field is set by the user prior to making a subsystem call. The meanings of the bits are: 

Bit 12 - operating system holds the current request until the subsystem is able to accept it. 

The C bit is not set until the request has been accepted and the processing of this re- 
quest is finished. 

1 - operating system returns control to the user if the subsystem is present, but is unable 
to accept the user's call. In this event, bit 2 in the ES field is set to 1 . 

Bit 13 - ES field is not set (with the possible exception of bit 2), and subsequent errors cause 
the UCP to abort. 

1 - operating system sets the ES to indicate which error condition occurred, and returns 
control to the user on non-fatal error conditions. (Fatal errors cause a UCP abort). 

A message is issued to the UCP dayfile indicating the error condition. 

The remaining bits in this word (14-59) are reserved. 

When either of the RT bits is set and a condition is encountered that causes any of the bits in the ES field to be 
set, the operating system sets the C field and considers the operation complete. It is therefore necessary to re- 
issue the CALLSS macro. 

WC Some subsystems require the user to specify the length of the parameter list. WC is the number 
of words (excluding the first word) that is to be passed with the request. The maximum is 
determined by the subsystem but may not exceed 77B. 

If a call is issued with auto-recall, the user's program is not restarted until the C field has been set. 

A subsystem can call another subsystem as long as this does not result in a circular chain reaction. An SCP 
cannot make a call to itself, unless bit 12 of the RT field is set. An attempt to call itself without bit 12 set 
can result in a subsystem hang. 

SYSTEM CONTROL POINT INTERFACES 

Three types of system communication interfaces are unique to subsystems: 

Subsystem notification to the operating system that it is entering active status, subsystem request 
acknowledgement, special requests to the operating system allowing the subsystem to: have access 
to the UCP field length, control and forward accounting data, obtain UCP swap and error status, 
transmit dayfile messages and error conditions to the UCP, and exit from active status. 
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Subsystems should use a symbolic reference for SCP locations and operations (e.g. refer to RA.SSID not RA+50; 
to SF.READ not 10). 



REQUESTING ACTIVE STATUS 

Subsystem notifies the operating system that it is entering active status. 

The operating system does not recognize' an SCP until a subsystem is loaded and ready to enter SCP status. The 
subsystem puts its name and code in RA.SSID (RA+50), which is used by the operating system to identify the 
subsystem and must be maintained at all times. A CALLSS macro using automatic recall is then executed with 
the ssid field equal to SS.SYS. 



Prior to assigning SCP status to the requesting control point, the operating system validates the following: 

Request is made with recall 

Program is called by a system origin job 

Subsystem name in RA.SSID matches that in the corresponding subsystem control table entry 

The same subsystem is not in SCP status at another control point and the maximum number of SCPs 
has not been reached 

If any of the above conditions are not met, an appropriate diagnostic message is entered in the dayfile and 
the job is aborted. Once the operating system has assigned SCP status to the subsystem, the C field is set if 1. 

If RT bit 13 is set, failure to meet either of the last two tests will not abort the job but will set the 
following codes in bits 6-11 of the ES field: 

04 - Another control point has SCP status for this subsystem 

05 - There are already nine control points with SCP status 

The format of SCP word RA.SSID is: 

59 17 



SSPN 



SSCODE 



where 

SSPN is the subsystem program name and 
SSCODE is the identification code (SS.XXX). 
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SUBSYSTEM REQUEST ACKNOWLEDGEMENT 

A word in the SCP field length, RA.SSC (RA+51), is set by the subsystem and used as a pointer to indicate where 
incoming requests from the UCP are put. The format of RA.SSC is: 



5fl 




53 


35 




17 


1 


00 


XP 


V 

F 


LP 


AP 



where 

AP is the address of the UCP parameter area 
LP is the length of the request parameter area 
VF is the variable move flag 
XP is the UCP exchange package address 
I is an interlock bit 

I is set by the operating system when a request has been placed in the parameter area. It is cleared by the 
subsystem to acknowledge that the request has been received. When the bit is cleared, AP points to a param- 
eter area in which the subsystem is prepared to receive the next request. After clearing I, the subsystem should 
not attempt to rewrite RA.SSC until the next request has been received. 

If it is necessary to force a request, it is possible for a subsystem to call itself if bit 12 of the RT field is 
set. Attempting a call to itself without this bit being set can result in a subsystem hang. 

If I is set at the time of the request, one of the following actions is performed, depending on bit 12 of the 
RT field: 

return control to the UCP and indicate a busy status in the ES field (RT=1) or 
hold the request and periodically attempt to give it to the SCP (RT=0). 

The word at the address AP has the following format: 



59 


47 


23 . 


17 


Reserved for 
Installation 


Reserved for CDC 


STAT 


ADOR 



ADDR is the same as the address in the CALLSS macro. This is a relative address within the UCP field length. 
STAT is zero if the call is from a user; l=normal termination of UCP, 2=error termination of UCP. 
AP+1 is the job identifier whose format is; 



59 


17 


Job name 


Job ordinal 
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AP+2 through AP+LP-1 (minimum value of LP is 2) contains LP-2 words which are from the UCP parameter 
list starting at ADDR. The UCP parameter list address is taken from the CALLSS macro call. 

If the VF bit is set, the length of the move is determined by the WC field in the UCP parameter word. If 
WC+3 is greater than LP, only LP words will be moved in. 

If XP is non-zero, the UCP exchange package is stored in the 16 words starting at XP. 

SPECIAL SUBSYSTEM REQUESTS TO THE OPERATING SYSTEM 

A subsystem at the SCP has the capability of making special requests of the operating system. These special 
requests, called Subsystem Functions (SFCALLs), are allowable from an SCP only. If an SFCALL is issued 
from a non-system control point, the control point is aborted with the error message PP CALL ERROR. 

The SFCALL macro call has the following format: 



label 



SFCALL 



addr .recall 



where 

label is an optional statement label. 

addr is the address of an SFCALL parameter word pair (see below). This parameter can be a 

register. 

recall if nonblank, the job is put into automatic recall. Although this option is allowed, 

its use by a subsystem is discouraged. 

A typical format of the SFCALL parameter word pair is: 



59 


53 


41 




23 


17 




5 


RC 


FP 


UCPA 


SCPA 


FC 


JNAME 


JO 



where 



RC is the reply code 

FP is the function parameter 

UCPA is the relative address within the UCP 

SCPA is the relative address within the SCP 

FC is the function code (an even number, incremented by one when the function has been 

completed) 
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JNAME is the job name and 

JO is the job ordinal (JDT or CP) 



If a parameter error prevents the processing of the function, RC will be set to a value in the range 40-77. 

The following list of SFCALL return codes (RC) gives all codes which have been defined. Not all of these 
codes apply to the SCOPE operating system. Codes 40-77 indicate that the function was not processed. 



Return 
Code 

00 
01-33 

34-37 

40 

41 

42 

43 

44 

45 

46-56 

57 

60 

61 

62 

63 

64 

65 

66 

67-73 

74-77 



Meaning 

No error encountered 

Trivial errors (Reserved for CDC) 

Trivial errors (Reserved for installations) 

At least one error encountered in list 

Job identifier invalid 

SCPA not within the subsystem FL 

UCPA not within the UCP FL 

User job swapped out 

User job not in system 

(Reserved for CDC) 

Connection previously established 

Connection rejected 

Connection not previously established 

Word transfer too long 

UCP not established with subsystem 

Subsystem not established with receiver 

Attempt to set illegal error flag 

Illegal dayfile processing flag 

(Reserved for CDC) 

(Reserved for installations) 



Possible return codes for each SFCALL function are: 



Function 


Return Code 


40 41 42 


43 44 45 


57 


60 61 62 


63 64 65 


66 


SF.REGR 

SF.TIME 

SF.ENDT 


X 
X 
X 


X X 
XXX 






X X 
X 




SF.READ 
SF.STAT 
SF.WRIT 


X 
X 


XXX 

X X 
XXX 




X 
X 


X 

X 




SF.EXIT 
SF.SLTC 
SF.CLTC 




X X 
X X 


X 


X 

X 


X 




SF.SWPO 

SF.SWPI 

SF.LIST 


X X 


X X 

X 

X X 




..„ 
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The function codes (octal) used with SFCALL are as follows: ' 

SF.REGR (02) Place message into the UCP dayfile and abort the UCP. 

SF.TIME (04) Obtain accounting data for SCP 

SF.ENDT (06) Indicate end of task to UCP 

SF.RE AD (1 0) Read from UCP field length 

SF.WRIT (14) Write to UCP field length 

SF.STAT (1 2) Request status of UCP 

SF.EXIT (1 6) Exit from SCP status 

SF.SWPO (24) Indicate UCP as candidate for swap-out 

SF.SWPI (26) Request swap-in of UCP 

SF.SLTC (30) Set the long-term connection indicator 

SF.CLTC (32) Clear the long-term connection indicator 

SF.LIST (34) Process a list of SF.xxxx functions 

(SF.SWPO and SF.SWPI are not implemented. They are treated as unknown functions (RC=47)). 



SF.INS1-4 



SF.REGR - REGRETS 



(70B, 72B, Reserved for installations. 
74B, 76) 



The SF.REGR function code places a message into the dayfile of the UCP and/or aborts the UCP. It has the 
following format. 

59 53 41 23 17 6 o 



RC 



FP 



UCPA 



SCPA 



JNAME 



02 



JO 



Definitions of the function codes are: 

UCPA = do not abort the UCP 

UCPA =£ abort the UCP. UCPA may have the following nonzero values: 

F.SExx (1) - General subsystem error 
F.SEHU (2) - Hostile user error 

no message 

address of a message that is to be sent to the UCP dayfile 

dayfile processing flags. The following is a list of the symbolic values and their meanings 
as defined for the FP field: 

F.SYCP to system dayfile, control point dayfile 

F.NMSN not to control point dayfile. 



SCPA = 
SCPA ± 
FP 
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F.JNMN 
F.CPON 
F.ACFN 
F.AJNN 
F.ERLN 
F.EJNN 



not to control point dayfile, job name in message 

to control point dayfile only 

accounting message to system dayfile only 

accounting message to system dayfile only, job name in message 

to error file only 

to error file only, job name in message 



SF.TIME - ACCOUNTING 

The SF.TIME function code allows the SCP to obtain the accumulated accounting totals at its own control point. 
The format is: 



59 




23 


17 




5 


Unused 


SCPA 


04 











where 



SCPA is the relative address within the SCP of a word block for raw accounting data. 



The accounting totals are returned to SCPA through SCPA+5 : 



SCPA+0 
SCPA+1 
SCPA+2 
SCPA+3 
SCPA+4 
SCPA+5 



CPA time 
CPB time 
I/O time 
CM field length 
ECS field length 
PP time 



The symbol L.SACT must be used by all subsystems to define the word block lengths (e.g., BSS L.SACT). It 
allows an installation to add a specially defined area to the word block by modifying the symbol and reassembling 
the subsystems using this symbol. The operating system is not responsible for setting or clearing the installation 



area. 



When an installation defines one or more words for installation usage, these words must be located by using the 
last address of each word block (first + L.SACT-1) and referencing installation words backwards from this address. 

Since the data delivered to this area varies among operating systems, a module must be provided for each operating 
system to process this area. . Multitasking users can use the data in this area to charge a particular UCP for the 
SCP resources used in processing the UCP's task. The resource data sent to the SCP can be the accumulated 
totals. The subsystem at the SCP has the responsibility for storing the previous totals of used resources and for 
calculating the differences. 
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SF.ENDT - SUBSYSTEM TASK COMPLETE 

The SF.ENDT function informs the operating system and the UCP that the subsystem task has been completed, 
and allows the SCP to distribute the accumulated resource costs back to the UCP. Its format is: 



59 




41 




23 


17 




5 


Unused 


UCPA 


SCPA 


06 


JNAM 


JO 





where 



UCPA is the relative address within the UCP of the request status word of the task being performed 

SCPA is the relative address within the SCP of a word block of raw accounting data. The content is 

the same as specified by the SF.TIME function. 

If UCPA > 0: 

Set bit zero of the word at UCPA. (Restart UCP if auto-recall was selected). Reduce the request count 
by one. 

If UCPA = 0: 

Do not set complete bit (bit 0). Reduce the request count by one. 
If UCPA =-1: 

Do not set complete bit. Reduce activity count to zero no matter how many requests are outstanding. 
(This activity count is the number of requests from the UCP ('JOBID') to this subsystem.) Clear the long 
term connection bit if it is set. 

If UCPA <-l: 

Return error 43. 

If SCPA =£ compute resource usage based upon the data provided at SCPA. The resource accumulators at the 
UCP are incremented with this computed resource data. The core seconds that are computed and added to the 
UCP are based on the SCP field length at SCPA+3. An SCP that is multi-tasking should not charge a single user 
for the full SCP field length, but use a somewhat smaller value in this field. Each of these fields can be passed 
to the SF.ENDT function exactly as returned to the SCP by the SF.TIME function, or they can be adjusted as 
required by the SCP. At a later time, the normal computation of the core seconds at the UCP includes the CP 
and I/O time of the SCP. The result is that the effective field length of CP and I/O time used by the SCP is the 
sum of the UCP and SCP field length. 



SF.READ and SF.WRIT 

SF.READ will move FP words from the UCPA to the SCPA whereas SF.WRIT will move FP words from the 
SCPA to the UCPA. 
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The format of SF.READ and SF.WRIT is as follows: 

59 53 41 



RC 



FP 



23 



17 



UCPA 



SCPA 



JNAME 



10/14 



JO 



If RC = 42B, the SCPA or SCPA+FP is outside the SCP field length; the SCP is aborted. If RC = 43B, the 
UCPA or UCPA+FP is outside the UCP field length. 

Transfers of large blocks of data between the UCP and SCP should be avoided because they may cause significant 
system response delays. Block transfers take place when the UCP calls an SCP or when an SCP makes an 
SF.READ or SF.WRIT request to read or write data to the UCP field length. Generally, no block transfer 
should attempt to transfer more than 64 words in one request or call. 

SF.STAT - STATUS 

The SCP uses the SF.STAT function to request the current status of the user job. The RC and 
FP fields are used for reply. 

RC = The UCP is not swapped out or being swapped out. The state of the connection indicator 
will be returned in FP as follows: 




1 Request Count 

Long Term Connection Bit 



The UCPA and SCPA fields are not used, but should be set to zero in case optional uses are assigned in 
the future. 

SF.EXIT - EXIT FROM SCP STATUS 

SF.EXIT will remove the SCP from SCP status. The following actions should be taken in the order specified: 

make an SF.EXIT call, 
clear RA.SSID, 
ENDRUN or ABORT. 
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SF.SWPO - SWAP OUT 

SF.SWPI - SWAP IN 

SF.SLTC - SET LONG TERM CONNECTION 

SF.CLTC - CLEAR LONG TERM CONNECTION 

These functions, along with the SF.ENDT described previously control the setting and clearing^ rfbitsmthe 
Inter-Job Connection Table (T.IJCT). The T.IJCT is a part of the Subsystem Control Table (T.SSCT) used to 
define and control SCP status. 

Each user job has a corresponding word in the T.IJCT that contains nine connection control fields. When a 
control point is assigned SCP status, it is assigned one of the nine fields in each T.IJCT word. The connection 
control field contains the following connection indicators: 

WAIT RESPONSE COUNT (alternately called Request Count) 

This three bit field contains the number of unanswered requests submitted to the SCP by the UCP. The 
count is incremented each time a CALLSS request is passed to the SCP and decremented by an SF.ENDT 
function with UCPA^O. 

LONG TERM CONNECTION 

This bit is set by SF.SLTC and cleared by SF.CLTC. An SCP sets this bit to be notified when the UCP 
is terminating because of either an ENDRUN or any abnormal termination. The method of notification 
is described below under End Processing for UCPs. 

SWAP OUT REQUESTED BIT 

This bit is set by the SF.SWPO and cleared by the SF.SWPI. If the swap out bit is set in any one of 
the connection control fields for a user control point, that job is treated as if its central memory time 
quantum has expired. This causes it to be swapped out unless it is locked in or there are no other jobs 
in the CM queue that could use the memory that would be released by swapping it out. 

WMle a job is swapped out, it is not aged as long as any of its connection control field swap out bits 
remain set. When an SF.SWPI function causes the swap out bit to be cleared, the UCP is artificially 
aged so that it can be swapped in again promptly. 
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Subsystems should use the SF.SWPO and SF.SWPI carefully because misuse can cause unnecessary and inefficient I 
swapping among its user jobs. { 

Neither the wait response count nor the long term connection is considered when a job is selected to be 
swapped out. If, however, any of the connection control fields has a nonzero wait response count and the 
swap out bit is not set, the swapping of that job will be delayed for over one second, if necessary, to give 
the subsystem a chance to complete the request before the user job is swapped out. 

An SF.SWPI function is not set complete until the swap in has been completed. If the swap out request bit 
is set for a different SCP, the UCP will remain a good candidate to be swapped out again. The existence of 
a wait response can, however, guarantee that it will be held at a control point for at least one second. 

END PROCESSING FOR UCPs 

If a program running at a UCP is terminated while there is a long term connection or a nonzero wait response 
count, the SCP is notified in the form of a two word call to the SCP. The STAT field in the word at AP+0 
is used to identify the termination notification. If the UCP was terminated by an ENDRUN, the STAT field 
contains the value one. In the event of an error condition the field contains the value two. All normal calls 
from the user contain a zero. 

When a subsystem receives termination notification, it should complete all requests as quickly as possible, 
issuing an SF.ENDT for each wait response and an SF.CLTC if the long term connection is set. Until this is 
done, the termination notification is repeated every two seconds and the message CONNECTED TO scpjobname 
is flashed at the UCP on the B display. 

If the subsystem is unable to complete the outstanding requests, it should issue an SF.ENDT to that UCP with 
a minus one (777776B) in the UCPA field to unconditionally release the UCP. 

If the CONNECTED TO scpjobname continues to flash for an extended period of time, it can be assumed that 
the SCP is not functioning correctly. The SCP and all of its connected UPCs can be terminated by an operator 
drop on the SCP. 

NORMAL SCP TERMINATION 

The following steps should be taken to terminate execution of a subsystem. 

Stop accepting any requests. 

Complete processing any requests already received. 

Issue an SF.EXIT. 

Do an ENDRUN. 

To force a subsystem to stop accepting requests, the user can have the subsystem send a dummy request to 
itself. The RT bit (bit 12) must be set whenever a CALLSS is issued. If bit 2 of the ES field is set, the 
operating system has delivered a request from another UCP, which must be processed along with any other 
uncompleted requests before the SF.EXIT is issued. The operating system will set the LK bit in RA.SSC and 
will not send any more requests as long as LK is not cleared. 
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ABNORMAL SCP TERMINATION 

A subsystem should make use of the RECOVR capability (see SCOPE Reference Manual) so that the subsystem 
will be reprieved if an error condition occurs. During reprieve processing it can attempt to complete all out- 
standing requests so as to cause as little user interruption as possible. The subsystem retains SCP status during 
reprieve processing. 

If a subsystem has completed reprieve processing or was not reprieved and attempts to terminate without 
issuing the SF.EXIT, the operating system performs the SF.EXIT and issues the message SYS CTL PT STATUS 
CANCELLED. 

When performing the SF.EXIT function, the operating system determines if the SCP still has any long term 
connection or active wait response counts with a UCP. If there are any, the following actions will be performed 
by the operating system. • 

SCP is aborted with the message EXIT - WITH CONNECTIONS. 

The wait response counts and long term connections are nullified. 

The message subsystem name ENDED BY SYSTEM is sent to the UCP dayfile. 

UCP is aborted. 



SF.LIST - PRESENTS A LIST OF SF.xxxx FUNCTIONS 

The multiple request capability is invoked through the use of the function code SF.LIST. The format of the 
SFCALL parameter word pair in this case is: 



59 




53 




41 




23 




5 





RC 


FP 





SCPA 


34 


JOBID 



RC = Reply Code 

FP = Number of entries in the list. 

SCPA = First word address of the contiguous parameter list. 



When using the list function, the entries in the list are each one word in length. The entry consists of the 
first word as described for each function. Only one UCP may be addressed for each list processed and this 
is the UCP indicated in the SF.LIST word pair. An SF.LIST function may not be included as a member of 
a list. 

When the FC field is set complete by the operating system, the RC and FP fields must be examined for proper 
action . 



If FP = 0, the entire list has been processed by the operating system. If FP is nonzero, processing of 
the list was abandoned and FP contains the number of entries remaining in the list. SCPA is set to the 
address of the first entry in the remaining list. The subsystem reissues the SF.LIST call by resetting the 
FC field and executing the SFCALL macro until FP = 0. 
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The operating system will set the RC field only if an error is detected. Multiple issues of the same 
SF.LIST request (until FC is set complete and FP is zero) accumulate error returns whether or not 
the entire list is processed on one SFCALL. 

Special conditions and notes. 

A. The operating system will abort the SCP during SF.LIST processing if a fatal error occurs in the 
SF.LIST, or in any member of the list. 

B. The detailed error conditions must be determined by examining the individual list entries whenever 
the SF.LIST RC field equals 40B. 

C. The individual functions are handled in exactly the same way whether or not the list mode is 
enabled. 

D. Error status 42B when SCPA is illegal means none of the list entries have been processed. This 
check is made prior to initiating the list process. 

E. Error status 42B when FP = means that none of the list entries have been processed on this 
call. If the subsystem improperly handles the FP = condition, the entire list may have been pro- 
cessed prior to the subsystem abort. 

F. List entries are processed sequentially by the operating system and those entries detected as 
erroneous for any reason are considered completed. It is expected that in most cases the entire 
list will be processed on one SFCALL. The option of abandoning the list is provided to allow the 
operating system to take corrective action if it decides that either the length of the list, the 
complexity of the processing or other reasons have caused (for example) an excessively long 
uninterruptable interval. 

G. If the SCP is aborted due to an error in one of the list entries other than the SF.LIST, RC = 40B, 
SCPA and FP are updated and FC is set complete. The proper return status is also placed in the 
offending list entry. 

H. The functions SF.REGR, SF.SWPI and SF.EXIT are performed by a PP program instead of 
CPMTR. When any of these are included in a list, processing is transferred to the PP for that 
function. When it is completed, the list is abandoned rather than attempting to transfer processing 
back to CPMTR. To process the remainder of the list it is necessary to reissue the SF.LIST function. 

HOW TO DEFINE A SUBSYSTEM 

The CMR symbol N.SBSYS determines if T.SSCT is assembled in CMR. The default value is zero which causes 
T.SSCT not to be assembled. N.SBSYS is the maximum number of subsystems that may be defined. If set to 
a nonzero value, that value must be at least 10B. Installations that want to define their own subsystems should 
use position ordinals 10B-17B. 

The SSCT macro is provided for defining subsystems. The macro has three parameters. 

SSPN Subsystem program name 

SSCODE Position ordinal for the subsystem 
PUF Permit User Files 

SSCODE is the unique code that identifies the subsystem and determines the position within T.SSCT at which 
the defining entry is assembled. Its value may not be greater than N.SBSYS. This is the same code that the 
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subsystem uses in RA.SSID when it requests system control point status. It is also used as the ssid for the 
CALLSS macro, to identify which subsystem is to be called. 

If the PUF parameter is omitted, the subsystem program must reside in the system library or it will not be 
granted system control point status. The PUF parameter should only be used during subsystem development. 



PROGRAMMING TIPS 

A system control point runs at a very high CPU priority level. When it receives a request from a user, the 
CPU is immediately assigned to process the request. In most cases the CPU will not be reassigned to any of 
the lower priority jobs until the SCP releases it by issuing an RCL. If the SCP uses the CPU inefficiently, 
monopolizing it for long periods of time, the throughput of the whole system will suffer. When subsystem 
action is blocked waiting for actions from other parts of the system, the CPU must be relinquished. 

It is also important that the subsystem be ready to accept and process requests from other users. Before 
issuing an RCL, it should be certain that the LK bit is not set, indicating that it is ready to receive a new 
request. The autorecall bit should not be used in any RA+1 call from an SCP because an autorecall status 
would prevent it from responding to new requests as they come along. 
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PERIPHERAL PROCESSORS AND SCOPE 



PERIPHERAL PROCESSOR ORGANIZATION 

When SCOPE 3.4 is loaded into the computer at deadstart time, system monitor, MTR, and the system dis- 
play program, DSD, are loaded into peripheral processors and 1, respectively, where they reside permanently. 
All peripheral processors in the system contain a group of permanently assigned storage locations called the 
PP direct cells; the contents of the direct cells are not guaranteed from one PP overlay to the next. Each ■ 

PP (except PPO and PP1) contains a copy of the PP resident program which handles common service functions | 
for the PP programs that may be loaded into the unassigned pool processors. 

PP programs are loaded into a pool processor by the PP resident and remain in a PP only until they have 
completed a specific function. When loaded, the program may load additional overlays to help complete its 
function; on completion, the program may be overlaid by another transient program loaded by PP resident 
to perform another, often unrelated, function. Figure 3-1 shows a typical layout of a pool PP loaded with 
a transient PP program and an overlay. The PP direct cells occupy locations to 77; the PP resident is 
loaded starting at location 103 to approximately 777. The remainder of the PP is occupied by PP transient 
programs, except for PPO and PP1 which contain MTR and DSD, respectively. 
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Specific assignment of the PP direct-cells is detailed in the following chart. 



Direct Cells 



Pointer to input register 



Pointer to message buffer 



Control point address 



Pointer to PP status word 



Field access flag 



Reserved 



Reserved 



PP Resident 



Transient Programs 



Secondary Overlays 



if 



74 D.PPIR 

75 D.PPMES1 

76 D.CPAD 

77 D.PPSTAT 
100 

101 
102 
103 



773 



1773 



7777 



Figure 3-1. Pool PP Layout 



* Cells 76 - 102 constitute the five bytes of the PP status word in central memory. 
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PP DIRECT CELL ASSIGNMENT 
Octal Identifier 




I 
2 

3 

4 

5 

6 

7 

10 

II 

12 

13 

14 

15 

16 

17 

20 



Function 



32 



37 



40 

45 
46 
47 
50 

55 

56 

57 
60 

62 

64 




Temporary 
storage 



output register buffer 



D.EST/D.JPAR 
D.TH2 

D.DTS/D.JFL 
D.TH7 



D.BA/D.FR0 

D.JECS/D.FR5 
D.JPR/D.FR6 
DJTL/DFR7 
D.PPIRB/D.FF0 

D.RA/D.FF5 

D.FL/D.FF6 

D.FA/D.FF7 
D.FIRST/D.SX0 

D.IN/D.SX2 

D.OUT/D.SX4 



D.FNT through D.FNT+9 contain words 2 and 
3 of the FNT, referred to as the file status table 
(FST). 

D.EST through D.EST+4 contain the EST entry in 
process. DJPAR contains a job parameter word. 

D.DTS contains device type code in left 6 bits 

and allocation type code in right 6 bits; D.JFL 

contains CM field length requirement returned to 

caller by 2TJ. 

Contains first word or FET in D.BA through 

D.BA+4 (buffer address). 

ECS field length returned by 2TJ to caller. 

Computed job priority returned to caller by 2TJ. 

Job time limit returned to caller by 2TJ. 

D.PPIRB through D.PPIRB + 4 contain PP input 

register contents. 

Reference address divided by 100 (octal) control 

point to which PP is attached. 

CM field length divided by 100 (octal) for job at 

control point to which PP is attached. 

Address of second word of FNT entry in process. 

This and next cell contain 1 8-bit CM address of 

word FIRST in circular I/O buffer. 

This and next cell contain 18-bit CM address of 

word IN in circular I/O buffer. 

This and next cell contain 18-bit CM address 

word OUT in circular I/O buffer. 
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Octal 



Identifier 



Function 



66 

70 

71 

72 

73 

74 

75 

76 

77 

100 

101 

102 



D.LIMIT/D.SX6 

D.PPONE/D.SV0 

D.HN/D.SV1 

D.TH/D.SV2 

D.TR/D.SV3 

D.PPIR/D.SV4 

D.PPMES1 

D.CPAD 

D.PPSTAT 



This and next cell contain 18-bit address of word 

LIMIT in circular I/O buffer. 

Preset to constant value plus one ( + I ). 

Preset to constant value + 100 (octal). 

Preset to constant value + 1000 (octal). 

Preset to constant value +3. 

PP input register address. 

Address of first word of PP message buffer. 

Address of control point area in use by PP. 

Pointer to PP status word. 

Field access flag. 

Channel time in seconds. 

Channel time in milliseconds. 



PP COMMUNICATIONS 

For each pool PP, CMR has an area used for communication between the PP monitor and the PP. Each 
area contains a PP input register and a PP output register, each one CM-word long, plus a six CM-word 
message buffer. In section 2, Figure 2-3 is a diagram of a PP communications area. 

When a PP is idle, the input register in the communications area contains zero. When PPMTR assigns a PP 
to load and run a transient PP program, it will load a request word into the assigned PP input register. 
Figure 3-2 shows the format of a PP input register for a transient program called from a CP program. 
CPMTR will have inserted the requesting program's control point number into bit 36-39 of the word and 
cleared bit 41. Bits 0-3S appear in the input register exactly as they did in RA+ 1 of the requesting CP 
program. 
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41 39 



35 



Program Name 

In 
Display Code 



c r 



CP 
No. 



c 



Parameters 



Recall flag 

- If RA + 1 call 

- 1 if internal call 



Figure 3-2. PP Input Register 
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The PP resident in each PP constantly scans its own input register. When it becomes non-zero, the PP resident 
isues the M.lCli monitor request with fcX.PLIB function code and the program name. A search is made for 
the program in the CMR library directory and the program is prepared for loading. The PP will load the tran- 
sient program at location 773 and store the address of the control point area to which the PP is assigned in 
direct cell D.CPAD, then transfer control to location 1000 to start execution. If the transient needs to load an 
overlay, it calls a subroutine in the PP resident. PP resident loads the overlay. Since the input register is not 
cleared until the PP becomes idle, parameters transmitted by PPMTR in the input register can be read by the 
transient program and/or any overlay. When the PP transient program has completed its function, it sends a 
request to PPMTR to drop the PP. PPMTR will clear the PP input register and record the fact that the PP is 
idle and that another program can be loaded into the PP. The transient program terminates by executing a 
jump to the idle loop of the PP resident which scans the input register for the next assigned task. 

When PP resident has a monitor request, it places a message into the PP output register in the PP commu- 
nication area. The leftmost byte contains a number which identifies the function requested; other bytes may 
contain parameters for the request. Additional information or parameters for the request may be placed in 
the message buffer in the PP communications area. After making the request, PP resident waits for the first 
byte of the output register to be set to zero, signalling that the monitor has processed the request. If 
CPMTR or PPMTR need to communicate with the PP about the request being processed, it will store the 
necessary information in the remaining bytes of the output register. 

PP RESIDENT 

The PP resident program performs two main functions: 

Handles all communication between MTR and the transient and/or overlay program 

Loads transient programs and overlays and initiates execution of these programs 

The PP resident is made up of a series of routines, each of which performs a specific function. (See figure 
3-3.) These resident routines are used by the transient and overlay programs as required. The routines, their 
names, locations, calling sequences and functions are described below. 
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Field Access Flags 



PP Resident Idle Loop 



Load Primary PP Overlay 



Request Access to Control Point Field Length 



Terminate Access to Control Point Field Length 



Compare Accumulator to Field Length 



Process Monitor Function 



Wait for Output Register to Clear 



Reserve Channel 



Drop Channel 



Mask a Byte into Specified Words 



Load PP Overlay 



Access Request Stack Entry 



Transmit Dayfile Message 



Transmit Data To/From PPU 



Read/Write Logic (Disk) 
Read/Write Segments (Non-disk I/O) 



R.FAF 

R.IDLE 

R.OVLJ 



R.RAFL 
R.PAUSE 



R.TAFL 

R.TFL 

R.MTR 
R.PROCES 

R.WAIT 

R.RCH 

R.DCH 



R.STBMSK 
R.STB 



R.OVL 



R.EREQS 



R.DFM 



R.WRITEP 
R.READP 



R.RWP 



Figure 3-3. PP Resident Routines 
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R.IDLE PP Resident Idle Loop 

Calling sequence: LJM R.IDLE 

In the idle loop. PP resident continually scans its input register for an assigned task. R.IDLE destroys direct 
cells 20 through 22 and some of the temporary storage cells; R.OVLJ and all other PP resident routines 
destroy only the temporary cells through 1 7. 

R.OVLJ Primary (transient program) Overlay Loader 

Calling sequence: Store name of overlay left-justified in D.T6, D.T7 

LJM R.OVLJ 

When this routine is called, the resident loads a new primary overlay at C.PPFWA minus L.PPHDR and 
transfers control to location C.PPFWA. 

R.OVL Overlay Loader 

Calling sequence: Load A register with load point address 

RJM R.OVL 

The M.ICE monitor function with EX.PLIB function is issued along with the overlay name found left justified 
in D.T6 and D.T7. The overlay is found and prepared for loading. After issuing the request, PP resident waits 
for byte of the PP output register to become zero and for word 3, byte of the PP message buffer to 
become non-zero. 

If the value of word 3, byte of the PP message buffer is 1, the overlay is disk resident. The stack request 
has already been issued by CP.MTR; therefore the resident establishes communication with the assigned stack 
processor and acquires the overlay through a channel. If the value is 5, the overlay is CM resident. The CM 

address of the overlay and length are given in the same PP message buffer third word. PP resident reads in 
the overlay. If the value if greater than 5, the overlay is ECS resident. The PP output register and the first 
four words of its message buffer are used for further communication between CP.MTR and the resident. The 
overlay is loaded from the CM data buffer area or directly from ECS through DDP according to the type of 
assigned system circular buffer. 

R.READP Transmit Data Via Channel from Stack Processor 

R.WRITEP Transmit Data Via Channel to Stack Processor 

Calling Sequence: Load L(request) 

RJM R.READP (R.WRITEP) 

Computes PP word count from first and last word addresses given in the request formatted at the request 
location and adds the computed word count, the address of the PP message buffer, and the control point 
number to the request. The request is entered in the stack, and data is transmitted via channel directly to/ 
from PP memory. Upon exit from R.READP (R.WRITEP). the following information is set: 

(D.T3 + C.RWPPLW) LWA+ I of data transmitted 

(D.T3 + C.RWPPST) Upper 6 bits of status 



60306500 K 3-7 



(D.T3 + C.RWPPWT) Number of PP words transmitted 

(D.T4 + C.RWPPST) Lower 12 bits of status 

R.RWP Special entry point to R.READP used by LDR. 

R.RWPP Word in R. READP modfied by LDR. 

R.EREQS Enter Stack Request 

Calling Sequence: Store L(request) in D.TO 

RJM R.EREQS 

This routine adds the control point number to the already formatted request and searches the central 
memory request stack for an empty entry. The monitor function, M.ICE/EX.SPM is called, and PP resident 
iterates until MTR accepts the request. If the available flag is set (S.STF + S.STFA of byte C.STFB of the 
second word of the request), R.EREQS exits to R.IDLE. Otherwise, it returns control to its caller. 

R.RAFL Request Control Point Field Length Access 

Calling Sequence: RJM R.RAFL 

The storage move flag for the control point is tested. If set, a call is made to R.TAFL; when clear, the field 
access flag in the PP status word is set, the RA in D.RA is reset, and the FL in D.FL is reset. 

(R.PAUSE is the same as R.RAFL.) 

R.TAFL Terminate Control Point Field Length Access 

Calling Sequence: RJM R.TAFL 

This routine is called to clear the field access flags in the PP byte R.FAF and in the PP status word. 

R.TFL Test Field Length 

Calling Sequence: Load relative address 

RJM R.TFL 

This routine ensures that a relative address is within the field length limits. The 18-bit address is added to the 
control point reference address and compared with the field length. If the resultant address is out of range, 
R.TFL exits with a zero A register; otherwise, the A register will contain the resultant absolute CM address 
(RA + relative address) upon exit. A call to RJRAFL sets a flag which enables R.TFL to return a reliable 
result. R.TAFL clears the flag. Therefore, the transient and its overlays must not call R.TFL until RRAFL 
has been called. 
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R.MTR Process Monitor Function 

(R.PROCES is identical with R.MTR) 

Calling Sequence: Store function parameters in D.T1 to D.T4 

Load function code 
RJM R.MTR 

Places the function code in D.TO, writes D.TO through D.T4 to the output register, and waits for the output 
register to clear via a call to R.WAIT. 

R.WAIT PP Wait Loop 

Calling Sequence: RJM R.WAIT 

Determines if the monitor function is for MTR or CPMTR. If the MXN instruction is not available, 
R.WAIT is modified at deadstart causing R.WAIT to assume that all functions are for MTR. If the function 
is for CPMTR, the PP input register address is written into T.PPID and T.MXNCTL is read in and 
executed. If the function is for MTR the input register address is written in T.PPIP. 

After either action, R.WAIT idles until byte zero of the output register is cleared. 

R.RCH Request Channel 

Calling Sequence: Load channel numbers 

RJM R.RCH 

Channel numbers loaded in the A register will be stored in D.Tl, the monitor function M.RCH inserted 
into D.T4, and then D.TO through D.T4 will be written to the output register for that PP. Channel numbers 
in D.Tl and D.T2 will be assigned by monitor on the following priority basis: 

DTP D.Tl D.T2 D.T3 D.T4 

"T " 



(2) l (1) 



T 



(4) ! (3) 



The highest priority is given to the channel number in the rightmost 6 bits of D.Tl; the second highest to 
the channel number in the leftmost 6 bits of D.Tl, etc. 

When assigning alternate channels, monitor will discontinue its search of D.Tl and D.T2 when it encoun- 
ters 6 zero bits. If only one alternate channel is wanted, the programmer must clear D.T2 before calling 
R.RCH. As an example, the coding for requesting primary channel 12 alternate channel 13 would be: 



LDN 





STD 


D.T2 


LDC 


1312B 


RJM 


R.RCH 



Normally, MTR will stop looking for alternate channels after four have been investigated; in the above 
example, only two channels will be investigated. 
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When R.RCH is called, the function is not considered complete until byte of the output register is cleared, 
which signals that a channel has been assigned. 

If an M.RCH channel request is made directly to R.MTR, additional action is taken. If MTR cannot assign 
a channel, it moves byte 4 of the output register to byte and signals the requesting PP in byte 4 of the 
output register to wait unit! the channel is assigned. 

R.DCH Drop Channel 

Calling Sequence: Load channel number 

RJM R.DCH 

The specified channel will be dropped. Since more than one PP can request the same channel at the same 
time, a MTR request must be used to reserve a channel. Only the PP reserving the channel can release it by 
making a R.DCH call; the function will modify the CST entry for the channel to indicate that it is free. 

RJSTBMSK 

Address in PP resident of a logical mask used by R.STB routine. This mask is initially 7700 octal; the value 
should be restored by any routine which substitutes an alternate mask. 

R.STB Store Byte 

Calling Sequence: Load L(List) 

RJM R.STB 

List has the form: 

L(BYTE) 

L(WORDl) 

L(WORD2) 



L(WORDn) 
ZERO 

A logical AND is performed on the mask at location R.STBMSK for each word in the list before the word 
is excIusive-ORed with word BYTE. R.STB is used primarily to substitute channel numbers in driver 
overlays. 

R.DFM Enter Dayfile Message 

Calling Sequence: Load L(message) + flag bits 

RJM R.DFM 
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A message is written to the dayfile and/or displayed on console. The flag bits in the high-order 6 bits of 
the A register are used to determine message destinations. In the flag bit values given below, one or more 
bits may be on; all are optional. Refer also to M.DFM. 

Bit Description 

Do not send message to B display 

If Do not send message to control point dayfile 

2ft Do not send message to system dayfile (A display) 

3 Flag the message as an accounting message 

4f Send the message to the hardware error file 

5ft Do not put the job name in the message 



FIELD ACCESS FLAG USAGE 

The control point field access flag (R.FAF) is found at location 1008 in PP resident. A copy of the flag is 
kept in CM in the PP status table entry (T.PPS1) for each PP. It is used by the PP to prevent storage 
moves at a control point while the PP is accessing the control point's field length. R.RAFL and R.TAFL 
(refer to descriptions in the previous , section) obtain and release field access. 

The field access flag must be set whenever data is read or written within a control point's field length. If a 
PP program is looping, waiting for an external event to occur, the loop must be performed while the field 
access flag is not set, or the loop must include a call to R.RAFL. When no field access is required for a 
major operation (such as searching a CMR table), it is advisable to call R.TAFL before the process. 

Execution of the R.MTR subroutine or any resident routine that calls R.MTR (that is, R.RCH, R.OVL, 
R.EREQS, R.DFM, R.READP, R.WRITEP, and R.RWP) may result in a call to R.RAFL. If an absolute 
CM address within a control point's field length has been computed and saved, the address will be invalidated 
because the control point may have been moved. 



f If bits 1 and 4 are set, the message is not sent to an INTERCOM control point dayfile, but is sent to 
other control points. 

ft If bits 2 and 5 are set, the time is omitted and replaced with blanks in the control point dayfile. This 
option is used to identify messages from a task that was executed on a different mainframe. 
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SCOPE SYSTEM MONITOR 

The monitor performs a set of functions that must be performed by a program that is permanently resident. 
Among these functions are: 

• CPU scheduling 

• Assignment of the PPs 

• Channel reservations 

• Time accounting 

• Storage requests 

• Other functions easily done by a centralized routine 

The monitor is implemented as two distinct components. MTR, which runs continuously in PPO, and CPMTR, 
which resides in central memory and uses the central processor intermittently for short bursts. 

The monitoring tasks are divided between the two processors on a functional basis to distribute the work load 
in the most efficient manner. 

CPU SCHEDULING 

A primary function of CPMTR is to assign the CPU to jobs at control points or to certain system programs 
that execute in program mode. The CPU status of jobs is controlled by PPs or by the job itself. CPMTR 
accepts requests for a change of status and records the current status as a set of bits in the control word 
(W.CPUST) associated with each exchange package. 

The most significant of these bits are: 

W This bit is set by a M.RCP or M.SETST when a central program is loaded for execution; 

it remains set until the program posts END in RA+1 or is aborted for any reason. 

C & D These bits are set when the job is being executed in CPU A or B, respectively. 

X The job is in periodic recall status because of an RCL request from the program. 

Y The job is in auto-recall status and will not be restarted until the requested system 

function is completed. 

Z The job is suspended as it threatened to saturate the system with PP calls. 

M, P & S Job execution has been temporarily suspended by storage move, checkpoint, or the job 

swapper, respectively. 

An exchange package exists for each control point, in addition to one for storage move and scheduler, and 
one for each CPU idle program. An exchange package is ready to use the CPU if W is on and M, P, S, X, 
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SYSTEM JOB EXCHANGE PACKAGE AREA 
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47 



T.XPSCM 

W.CPSLIC 
W.CPUST 
W.CPLINK 

W.CPTIME 

W.CPTIMB 

W.PPTIME 

W.XPIR 

W.XPOR 

Scheduler Only 
T.SCHRS 

T.MTRRS 
T.XPIDLA 



I" 



38 



29 



23 



17 14 11 



Exchange Package 

for 

Scheduler and Storage Move 



C.CPSTAT 
Status Byte 



C.CPSLIC 

M.RCLCP 
Time 



C.CPUPRI 
CCPLINK 



Next Active 
Control Point 



CPlkA Scheduler/Storage Move Time 



CPU-B Scheduler/Storage Move Time 



W.CPSLIC 
W.CPUST 
W.CPLINK 

W.CPTIME 

W.CPTIMB 

W.PPTIME 

W.XP1R 

T.XPIDLB 



W.CPSLIC 
W.CPUST 
W.CPLINK 

W.CPTIME 

W.CPTIMB 
W.PPTIME 
W.XPIR 



PPU Idle Time 



Scheduler Input Register 



Scheduler Output Register 



Scheduler Request Stack Table 



L.SCHRS-4 



CPMTR MTR Request Stack 



L.MTRRS-4 



CPU-A Idle Program Exchange Package 
P-CPMTR (If IP.ECSB^, 

FL-400000B ECS FL-177777778 

B2-1 B5-L.ECSTK 

B7-0 A6-T.EPAGE) 



C.CPSTAT 
Status Byte 



C.CPSLIC 
M.RCLCP 
Time 



CCPUPRI 
CCPLINK 



Next Active 
Control Point 



CPU-A Idle Time 



£ 



(If IP.MCPU»2> CPU-B Idle Program Exchange Package 
P-CP.MTR (If IP.£CSB*0, 

FL-400000B ECS FL-17777777B 

B2-1 B5-L.ECSTK 

B7-1 Af>T.EPAGE) 



C.CPSTAT 
Status Byte 



C.CPSLIC 
M.RCLCP 
Time 



C.CPUPRI 
CCPLINK 



Next Active 
Control Point 



CPU-B Idle Time 



^ 



? 



Figure 3-4 
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Y, and Z are all off. CFMTR assigns the exchange package to the CPU on a priority basis. The priority used 
is the CPU priority. 

The CPU priority is a 6-bit field in the CPU status word. Priority levels, in ascending order, are listed below: 

PR.IDLE Zero level default CPU job to be used only in the absence of any other 

PR.BATCH Batch jobs initiated by 1 IB 

PRINT INTERCOM jobs initiated by 1SI 

PR.SCP System control point jobs initiated by DSD 

PR.SYS Storage move and scheduler 

When more than one job is at the highest active priority level, they will share the CPU on a round-robin 
basis. Each uses the CPU for BASESUC milliseconds before control is passed to next. 

This combination of priority and round-robin scheduling is overridden during the time that an RMS driver is 
transferring data to or from a user's buffer. If the user's program is not in auto-recall, it is given a slice of 
CPU time so that it can process the data as it is transferred. In this way, a low priority job may temporarily 
preempt the CPU away from a high priority job. 

When CPMTR assigns the CPU to a job, the BASESLIC is added to the current time, to produce the projected 
end of slice time. The end of slice time is posted in T.CPSTA (or T.CPSTB). When the time arrives, MTR 
issues an M.SLICE function which causes CPMTR to select the next job for the CPU. 

ASSIGNMENT OF THE PPs 

PP scheduling is done by MTR. A PP can be requested by a CPU program through a call in RA+1, or by 
another PP through an M.RPJ or M.EES monitor function. 

MTR always reserves at least one PP for the RMS stack processors to ensure that the stack processor is not 
locked out while all programs in the PPs are waiting for stack processor to access RMS. More than one PP 
can be reserved for the stack processors. (See N.SPRPP in CMR.) MTR maintains three lists of PP calls 
that are not currently assigned to a PP. 

PP Job Queue. This is the overflow list where PP calls are placed when no PP is available. It is a first 
in first out, ordered queue except for stack processors. A PP call that MTR identifies as a stack 
processor will be added at the front of the list, pushing down all the members already in the list. 

Delay Stack. This is a list of PP calls for the M.RPJ function with a nonzero time delay. They are 
ordered in sequence of their time delay. When the delay is expired, they are removed from the delay 
stack and assigned to a PP or added to the PP job queue if no PP is available. 

Event stack. This is a list of PP calls for the M.EES function. It is searched periodically to find any 
entries whose event has occurred. When one is found it is removed from the event stack and assigned 
to a PP or added to the PP job queue if no PP is available. 
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MTR keeps the control values for these lists in PPO. The PP calls are kept in the peripheral job table (T.PJT) 
in central memory. Each call consists of the input register and three words for the PP message buffer. When 
a PJT entry is not in use, the input register word is set to zero. 



CHANNEL RESERVATIONS 

CPMTR processes channel reservations. The CPU is used for this frequently used function as it is easily 
accessed from PP resident. If the requested channel is already busy, MTR periodically reissues the request 
to CPMTR. 



TIME ACCOUNTING 

MTR uses the real time clock on channel 14g as the source for its time keeping duties. MTR maintains the 
two basic system time clocks T.CLK and T.MSC. T.CLK is a 24-hour clock that gives the time of day in 
hours, minutes and seconds. 

Bits 12-35 of T.MSC contain the total number of seconds since the last deadstart, expressed as a 24-bit 
binary number. Bits 0-11 are the binary fractional parts of a second. Bits 0-35 contain a continuous binary 
number recording the time as seconds times 4096, which is used as the accounting basis for CPU time, I/O 
time and PP time. 

CPU time is compiled by CPMTR. Each time the CPU is rescheduled, the current value of T.MSC is re- 
corded so that the elapsed time can be computed the next time the CPU is rescheduled. 

MTR accumulates I/O time and PP time, except that portion for RMS devices. This part is accumulated by 
CPMTR from a PRU count that is passed to it in the M.SPRCL function from stack processor. 



STORAGE REQUESTS 

MTR and integrated scheduler perform the memory management tasks in a synchronized procedure. MTR will 
attempt to process storage requests. If storage is not available, MTR will initiate scheduler to determine if 
storage will be made available. MTR will not attempt to process any storage requests while scheduler is 
running. 



CPMTR ORGANIZATION 

CPMTR is the one central program that has no exchange package area of its own. It runs in monitor mode 
and selects the user mode programs to be run next. When CPMTR is not running, its exchange package is 
stored in the area reserved for the user mode program selected to be run. The user mode program makes a 
system request by placing the system call in the word at RA+1 and performing a central exchange jump (XJ) 
instruction. This reinitiates the execution of CPMTR and saves the register contents of the user mode pro- 
gram in its exchange package area. 

PP programs also can direct system requests to CPMTR. Typically, they use the RMTR routine of PP 
resident for such requests. R.MTR places the monitor function in its output register and then determines if 
the function should be directed to CPMTR or to MTR. When calling CPMTR, the PP input register address 
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is written in T.PPID so CPMTR can identify the calling PP without scanning all the output registers. Then 
the PP resident routine executes the monitor exchange jump (either MAN or MXN) to initiate CPMTR execu- 
tion. MAN causes an exchange jump to the address in the CPU's MA register; MXN causes an exchange 
jump to the address in the PFs A register. When the system is using the MXN (IP.XJ=1), CPMTR maintains 
a special control word at T.MSNCTL. This word is read and executed by PP resident to ensure that the 
correct exchange jump address is used with the MXN. 

When CPMTR begins, it must determine why it was called. It first checks RA+1 of the user mode program 
that was running. If RA+1 is non-zero, its content is picked up by CPMTR and RA+1 is cleared. This call 
is compared against a list of system calls to be performed immediately by CPMTR. If not one of these, the 
call is placed into the small buffer at T.MTRRS where MTR assigns it to a PP. If the RA+1 call does not 
have the auto-recall bit set, CPMTR immediately returns control to the user program. 

If the auto-recall bit is set, CPMTR sets that control point into auto-recall status and reassigns the CPU to 
another user program. 

The list of system calls performed by CPMTR includes ABT, END, RCL, TIM, XJR and others. 

If RA+1 is empty, T.PPID is checked. If an input register address is in T.PPID, CPMTR clears it and checks 
the corresponding output register for a function to be performed. The CPMTR functions are described with 
the other monitor functions. 

If RA+1 and T.PPID are both empty, MTR's output register is checked. This extra check is made because 
MTR does not use T.PPID when it issues a CPMTR function. Otherwise, a function from MTR is handled 
just like any other PP. 

If CPMTR cannot determine why it was called, it returns control to the interrupted user program. 

MTR STRUCTURE 

Unlike CPMTR, MTR is not initiated to perform a specific function. It runs continuously and must keep 
searching for requests directed to it. The frequency with which it scans for each type of request can have 
major impact on system efficiency. The following major responsibilities are listed in an order which corre- 
sponds roughly to the frequency with which they should be performed. 

• Advance system clocks 

The accuracy of the system clocks in T.CLK and T.MSC is directly related to the frequency with which 
MTR accesses the real time clock on channel 14g. 

• Check T.PPIP 

This is the word into which PP resident writes its input register address when it has a monitor function 
for MTR. Frequent checking reduces the MTR response time and reduces chances of conflict between 
two PPs in the use of this word. 
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• Check T.MTRRS 

This is the short buffer through which CPMTR passes PP calls taken from RA+1. It is also used for 
some PP monitor functions called by CPMTR or scheduler (M.SEF or M.ISP). MTR should keep this 
buffer clear so that it will not inhibit the efficient execution of CPMTR. 

• Check individual PP output registers 

T.PPIP is used for quick attention from MTR on monitor functions. It is still necessary for MTR to 
scan the output registers because if two PPs make requests in near unison, one will be lost from T.PPIP- 
Also several monitor functions, such as M.BUFPTR, M.DFM, M.RCH and M.RSTOR, may not be com- 
pleted on their first processing. These functions will be processed more quickly if the output registers 
are scanned more frequently. 

• Advance control point 

Examine each control point in turn to see if a PP program should be initiated from the event stack, if 
the CPU should be restarted from recall status, or if 1AJ should be called to advance to the next control 
statement. 

• Check RA+1 

Examine RA+1; and if it is nonzero, initiate CPMTR. This function is intended only to initiate CPMTR 
for a program that does not use the exchange jump capability. 

MONITOR FUNCTIONS 

The following descriptions of the monitor functions are in alphabetic order. The tables in Part II, section 1 , 
of this manual list the monitor functions in numerical sequence. Functions with a code number of less than 
or equal to M.MTRCPU are assigned to CPMTR. 

M.ABORT ABORT CONTROL POINT AND DROP PP 

(M ABORT **** **** **** ****■) 

The job at the requesting PPU is terminated. The requesting processor is responsible for the dayfile message. 
Operation of this function is identical with function M.DPP except that the error flag in the control point 
area is set to F.ERPP to note the abort function. 

M.BUFPTR WATCH BUFFER POINTER WORD 

(M,BUFPTR,****,****,OOAA,AAAA) 

AAAAAA Buffer pointer address. 

I/O drivers use this function to give MTR the absolute address of the buffer pointer that is being updated. 
MTR monitors the value of that pointer and when it changes, restarts the control point if it is in periodic 
recall. 
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M.CCPA CHANGE CONTROL POINT ASSIGNMENT ■ 

(M.CCPA **** **** **** **NN) I 

The requesting PPU is released from its current control point assignment as if it had issued an M.DPP func- 
tion, but its input register is not cleared. The PPU is assigned to control point NN, and the new control point | 
number inserted in its input register. It is the responsibility of the requesting PP to alter D.CPAD. R.TAFL 
should also be used to clear the field access flag at the old control point. 

M.CLRST CLEAR STATUS 

(M.CLRST,BBBB,****,****,OONN) 

BBBB Pattern of bits to be cleared 

NN Control point number (only is in MTR output register) 

Called to clear CP status bits in byte C.CPSTAT in control point linkage. Will cause linkage to or delinkage 
from chain of control points actively waiting for a CPU. 

M.CPJ CAPTURE PERIPHERAL JOB 

(M.CPJ,00XX,XXXX,****,****) 

XXXXXX Buffer address, relative to RA 

This request is issued to find a job for a control point either in the event stack or in the PP delay stack. 
The event stack is searched first; if a job is found, its data is written to the buffer whose address is given 
in the request. When the end of the delay stack is reached, the function is completed. 

M.CPUST CHANGE CPU STATUS 

(M.CPUST,000X,****,****,****) 

X = If either CPU is OFF, it is turned ON. If the CPU was locked OFF at deadstart time, 

it remains OFF. 

X = 1 If both CPUs are ON, CPU-A is turned OFF. 

X = 2 If both CPUs are ON, CPU^B is turned OFF. 

When the requested function cannot be performed, no action is taken. 

M.DCP DROP CENTRAL PROCESSOR JOB 

(M DCP **** **** **** ****•} 

Execution of the central processor job at control point is stopped. The control point status bits W, X, Y, 
and Z are cleared. The control point status bits set prior to M.DCP are returned in byte 1 of the output 
register of the requesting PPU. 
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M.DFM PROCESS DAYFILE MESSAGE 

(M.DFM,FFFF,MMMM,****,****) 

Dayfile flag bits FFFF determines message handling: 

Do not send message to B display 

1 Do not send message to control point dayfile 

2 Do not send message to system dayfile (no A display) 

3 Flag message as an accounting message 

4 Send message to hardware error file 

5 Do not insert job name in system dayfile 

If bits 1 and 4 are both set, the message is not sent to an INTERCOM control point dayfile, but is sent to 
other control points. If bits 2 and 5 are both set, the time is omitted and replaced with blanks in the 
control point dayfile. This option is used to identify messages from a task that was executed on a different 
mainframe. 

If bit 3 is set, a dollar sign precedes the dayfile entry to identify it as an accounting message. If bit 5 is 
also set, the dollar sign is suppressed on the assumption that a job which is not identified by a job name 
cannot be billed for resources. 

When the value of MMMM is greater than that in PPOR, it is taken to be the LWA + 1 of the message in 
the PP message buffer. When the value is less than that in PPOR, MMMM is taken to be a dump index for 
a requested dayfile dump. 

Value of dayfile dump index!: 

System dayfile dump 

1 thru N.CP Control point dayfile dump 
N.CP+1 Hardware error file dump 

M.DPP DROP PP 

fM DPP FFFF **** **** ****") 

MTR clears the PP control assignment (the PP status word and the PP input are cleared). If the value of 
FFFF represents M.DPP, the PP time is not incremented. 

M.EES ENTER EVENT STACK 

(M.EES,OOAA,AAAA,****,SYTT) 

AAAAAA Word address in Event Stack 

Y Byte address in word AAAAAA 

TT Bit address in byte Y 

S Combined value of F and B: 

F = Event stack job assigned when bit is off (F.ESOFF) 

F = 4 Event stack job assigned when bit is on (F.ESON) 

B = AAAAAA is an absolute address (F.ESABS) 

B = 1 AAAAAA is relative to RA (F.ESREL) 

B = 2 AAAAAA is a control point area address (F.ESCPA) 
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This function is used to call a PP program after a specified event has occurred. That event must be defined 
as a specific bit being set or off. The bit is defined by the parameters in the output registers. WJPPMES1 
contains the input register image of the program that is to be assigned when the event occurs. The contents 
of W.PPMES4, W.PPMES5, and W.PPMES6 are also saved and set in the message buffer when the program 
is called. This function will not complete if the peripheral job table is full. If possible, use M.EESD instead 
of M.EES. 

M.EESD ENTER EVENT STACK AND DROP PPU 

(M.EESD,OOAA,AAAA,FFFF,SYTT) 

Combines the functions of M.EES and M.DPP. This function will be completed even if the peripheral job 
table is full. If FFFF=M.EESD, the control point will not be charged for the PP time. All other parameters 
are identical to M.EES. 

M.ICE INITIATE CENTRAL EXECUTIVE 

(M.ICE,PPPP,PPPPJPPP,EX.xxx) 

EX.xxx is a subfunction to be performed. See part II, section 1, under Monitor Functions, for a listing of 
these subfunctions. The PPPP fields can be used as parameters to the subfunction. Subfunction routines 
may run in either monitor mode or user mode. Those run in user mode use the exchange package at 
T.XPSCH. The content of the M.ICE call is placed into the user mode input register at T.SPSCH+W.XPIR 
before the user mode routine is initiated. This input register is cleared to signal completion. 

M.ISP INITIATE STACK PROCESSOR 

(M.ISP,00OX,00ON,****,CCCC) 

CCCC DST ordinal of stack processor to be initiated 

X = Initiate 1SS only if PP active flag is zero 

X ¥=0 Initiate 1SS regardless of PP active flag setting 

N = Initial assignment of ISP to the DST entry 

N = 1 (or 2) A partner call 

A check is made to see if a PP is assigned to this DST ordinal. If there is none, a check for an available 
PP is made. If an available one is found, set the PP active flag and place the DST ordinal and 1S5 in its 
input register. If a PP is found to be assigned to the DST ordinal, the setting of X determines if 1S5 is to 
be initiated or not. If not set, the output register is cleared and an exit made; if set, proceed as for an 
available PP. If the PP job stack is full, the routine is exited. The 1S5 program is the PP input register 
DST ordinal checker and stack processor loader. When N is 1 or 2 and X # 0, this is a call from ISP for 
a partner to work together for a dual access device. 

M.KILL BAD FUNCTION REQUEST 

(M.KILL,****,****,****,****) 

MTR flags the function request as bad and automatically enters STEP mode. The requesting PP is hung. 
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M.NTIME ENTER NEW TIME LIMIT 

(M.NTIME,TTTT,T**V**V*NN) 

A central processor job time limit of TTTTT seconds is entered at the control point. Any previous time 
limit is superseded. If the requesting PPU is assigned to control point zero, the parameter NN will give the 
number of the control point to be considered; in any other case this parameter is irrelevant. 

M.PASS PPMTR IGNORES FUNCTION REQUEST 

(M.PASS ******** ****,****) 

Indicates a no-operation by PPMTR which will be cleared by another routine. 

M.PATCH INSERT A PATCH IN PPMTR 

(M.PATCH,AAAA ) BBBB,CCCC,DDDD) 

The routine inserts a patch in the monitor program at the address indicated. 
AAAA Insertion address for patch BBBB 

CCCC Insertion address for patch DDDD 



M.RACT REQUEST CONTROL POINT ACTIVITY 

(M.RACT,**NN,IIII,****,****) 

This request provides the various activity counts of control point NN at a given time (NN cannot be zero). If 
IIII i S nonzero, the pseudo-activity count will be incremented or decremented by the constant IIII (after sign 
extension). Monitor replies through the PP output register: 

Byte 1 Control point status byte 

Byte 2 General activity count 

Byte 3 Count of outstanding delayed PP requests 

Byte 4 Pseudo-activity count 

M.RBTSTO REQUEST RBT STORAGE 

(M.RBTSTO,SSSS,****,****,****) 

PPMTR sets SSSS*100 as the new RBT starting address. If the request cannot be honored, the old RBT 
starting address is returned in SSSS. 
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M.RCH REQUEST CHANNEL RESERVATION 

(M.RCH,BBAA,DDCC,***G,RRRR) 

AA 1st choice channel number 

SB 2nd choice channel number 

CC 3rd choice channel number 

DD 4th choice channel number 

G = ° Normal charge for channel time. 

G = 4 Do not charge control point for channel time. 

RRRR = 0000 Request immediate reply. 

RRRR * 000 ° No reply until a requested channel has been reserved. 

When channel zero is requested, it must be field AA. Zero BB, CC, or DD implies no more choices. If none 
of the requested channels is available, PPMTR will set byte of the PPU output register to zero. When a 
channel is granted, its number is returned in the PPU output register byte 1 (location of AA) and byte 4 is 
set to non-zero value. Thus, programs that request an immediate reply must check that byte 4 is non-zero 
before using the channel. 

On exit, if a channel has been reserved, the output register appears: 

0000 XXXX TTTG TTTT YYYY 

XXXX Channel number 

TTTG TTTT Information from the channel status word, where G is the charge/ 

no charge bit for channel time. 

YYYY PP input register address 

M.RCLCP RECALL CENTRAL PROGRAM 

(M.RCLCP,****,****,**** ****) 

This request is effective only if the central program associated with the requesting PPU is in recall status, and 
no error flag is set at the control point. The status of the control point is set to waiting (W). In any other 
case, the status of the control point is not altered. 

M.RCP REQUEST CENTRAL PROCESSOR 

(M.RCP,****, ******** ****\ 

This request is ignored under the following conditions: 

Requesting PPU is assigned to control point zero 

Error flag is set for the control point 

Job is already in the waiting status. 
If none of the above conditions exist, CPMTR sets the job in waiting status (W). 
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M.RPJ REQUEST PERIPHERAL JOB 

(M.RPJ,SSSS,FFFF,****,****) 

This function requests that another PPU program be initiated after a specified time delay. The first word of 
the requesting PPU message buffer contains the input register image of the new PPU program. The time delay 
is SSSS seconds plus FFFF/10,000B seconds. If the time delay is zero and no PPU is available, the request is 
entered in the PP job queue. If no space is available in the PP job queue buffer of PPMTR, the entire re- 
quest remains pending until a queue entry becomes free. M.RPJD should be used in preference to M.RPJ 
whenever possible. 

M.RPJD REQUEST PERIPHERAL JOB AND DROP PPU 

(M.RPJD,DDDD ) DDDD,FFFF,****) 

Combines the functions of M.RPJ and M.DPP. This fucntion will be completed even if the peripheral job 
table is full. If FFFF=M.RPJ, the control point will not be charged for the PP time. _ The use of the time 
delay is the same as for M.RPJ. 

M.RSTOR REQUEST STORAGE 
| (M.RSTOR,CCCC,XXXX,00TT,****) 

CCCC Requested CM/ 100 octal 

XXXX Requested ECS/1000 octal 

TT 00 CM request only 

01 ECS request only 

02 CM and ECS request 

03 Request reserved CM 

04 Request CM-will await response 

06 Request CM and ECS-will await response 

07 IP.POSFL requested by swapper 
20 Priority storage requested 

Assign CCCC central memory and/or XXXX extended core storage to the control point of the requesting PPU 
Monitor replies to this request by setting CCCC and/or XXXX to the values actually assigned to the control 
point and by setting byte to zero. These values should be compared with the original values requested to 
determine whether these requests have been honored or not. A request for more storage is rejected if not 
enough storage is available or if a storage move is already in progress. A request for less storage always is 
honored immediately. If TT = 02, PPMTR can honor part of the request without honoring the remainder. 



MEMORY ALLOCATION 

Central memory and direct-access extended core storage is assigned in the same sequence as control point 
numbers. Storage associated with any control point is contiguous. 
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All storage is associated with the assigned control points. If no user jobs are assigned to control points, all 
storage is associated with the central memory resident, which operates at control point zero. All storage, 
therefore, falls into one of two categories: 

Allocated storage, defined by the RA and FL of the control point. 

Unallocated storage, defined as that which occurs between the allocated storage of two consecutive 
control points. All unallocated storage is associated with the lower numbered control point. 

PPMTR maintains two tables in PP zero which contain the size of allocated and unallocated CM and ECS 
storage associated with each control point (0 through N.CP)- A request for reduced field length will have 
the effect of reducing the amount of allocated storage and transferring the value to unallocated status; no 
storage is actually moved. When the total storage associated with a control point is sufficient, a request for 
an increased field length will cause transfer of the increased value from the unallocated to allocated state; 
no actual storage move takes place. 

If there is insufficient storage associated with a control point to satisfy an increased field length request, 
unallocated storage may be transferred from adjacent control points. A scan of the unallocated storage table 
entries for the adjacent control points will locate a combination of blocks which results in moving the least 
amount of storage. 

When a control point RA and/or FL is to be changed. PPMTR will suspend the control point by setting the 
M bit of the CP status byte. If a CM move is necessary. PPMTR will set the storage move flag and wait for 
all PPs assigned to the control point to pause and then initiates the system exchange package to start the 
storage move program. After completion of the move, PPMTR will modify the control point RA and/or FL 
and resume the control point by clearing the M status bit. 

A PPU pause occurs when the field access flag (C.FAF) in the PP status word is zero. If an ECS parity 
error occurs during an ECS move, PPMTR will abort both the requesting control point and the control point 
whose ECS is being moved, if it is no longer intact. 

M.SCB SYSTEM CIRCULAR BUFFER SURVEILLANCE 

(M.SCB,****,00BB,BBBB,EX.CBM) 

BBBBBB = System Circular Buffer Address 

The system circular buffer is an FET-like table that has a trigger and a direction flag in addition to FIRST, 
IN, OUT and LIMIT. MTR uses IN, OUT, and the trigger and direction (RMS-to-ECS or ECS-to-RMS) to 
determine if a threshold has been reached. If not, no action is taken. If so, MTR issues an M.ICE/EX.CBM 
function to start CBM for processing of the system circular buffer. 

M.SCH INITIATE INTEGRATED SCHEDULER 

(M.SCH,000X,00CC,00JJ,JJJJ) 

When X = 2, the contents of this output register are placed into a buffer at T.SCHRS for integrated 
scheduler's attention during its next normal execution. Integrated scheduler is not initiated immediately. 
When integrated scheduler processes this request it will link the JDT at location JJJJJJ to the job queue 
for JCA ordinal CC. If CC is zero, the job class is taken from the JDT. 

When X ^ 2, the output register contents are not passed to scheduler. Both types cause MTR to initiate 
scheduler. 
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M.SEF SET ERROR FLAG 

(M.SEF,**NN,EEEE,****,****) 

Monitor will drop the central program at control point NN by putting the program in zero status, and setting 
the error flag to the value EEEE. 

The M.SEF function recognizes two special control values in the error flag field that are used to initiate and 
terminate the memo mode. 

When a control point is in memo mode, error flags are not set in byte CCPEF(l), but are recorded in 

bits 0-5 of byte C.CPMEMO(0). The high order bits (6-11) of CCPMEMO are set on when the control point 

is in memo mode, and are used by MTR to recognize the mode. 

F.ERMEMO (-77B) is used to initiate memo mode. Bits 6-11 of CCPMEMO are set on. Bits 0-5 of 
C.CPEF are moved to bits 0-5 of CCPMEMO and C.CPEF is cleared. If the control point is already in 
memo mode, the effect of the F.ERMEMO is to clear an error flag memo without terminating the memo 
mode. 

F.ERTMM (-0) is used to terminate memo mode. Bits 0-5 of CCPMEMO are moved to C.CPEF and 
CCPMEMO is cleared. Error flag zero can also be used to terminate memo mode, but it will clear both the 
error memo and the error flag fields. If an error memo is already recorded when the F.ERTMM is issued, 
the memo will be made an error flag causing the normal error flag processing to take place. 

When a control point is in memo mode, the M.SEF function with error flag values 1 through 77B will not 
cause the CPU to be dropped as when in normal error flag mode; however, there are some exceptions. The 
following error codes are caused by errors in the central program and render the CPU useless. 

2 F.ERAR Arithmetic error 

4 F.ERCP CPU abort (ABT in RA+1) 

5 F.ERPCE PP call error (garbage in RA+1) 

15 F.ERRCL Auto-recall error 

Any of these codes will cause the control point to revert to normal error flag mode. 
Cautions 

When entering memo mode it is possible that an error flag had been set just prior to the processing of the 
F.ERMEMO. The PP program that initiates memo mode should immediately check the error memo field 
after completion of the F.ERMEMO. If an error memo is set it should be assumed that it occurred as an 
error flag prior to the F.ERMEMO. Usually the best action at this point is an F.ERTMM. Since the pro- 
gram is not yet committed to its critical stage, it is best to allow the error flag processing to continue. 

Memo mode is restricted to use during single control card executions only. It is the responsibility of the 
program that initiates memo mode to terminate it. If 1AJ finds a control point in memo mode, it will 
process it as an error flag. 

M.SEQ ASSIGN JOB SEQUENCE NUMBER 

(M.SEQ,****,****,****,****) 

Monitor returns in byte 1 of the FPU output register a job sequence number (in display code). 
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M.SETST SET STATUS BITS 

(M.SETST,BBBB,****,****0ONN) 

BBBB Pattern of bits to be set 

NN Control point number (only if in MTR output register) 

Called to set CP status bits in byte C.CPSTAT in control point NN area. May cause linkage to or delinkage 
. from chain of control points actively waiting for a CPU. 

M.SLICE TERMINATE TIME SLICE PERIOD 

QA.SUCE ******** ********) 

Only the PPMTR can issue this function request. It is issued to interrupt an executing user mode program so 
that CPMTR can reschedule the use of CPUs. 

M.SPM SPM CALL FROM ISP 
(M.SPM, PPPP, PPPP, PPPP, EX.xxx) 

The PPPP fields are subfunction parameters. 

EX.xxx is the subfunction to be performed as follows: 

EX.SPRCL Stack processor recall. SPM is called to terminate the actual I/O portion of the current 
stack request. SPM will terminate, reissue or otherwise further process the stack request 
and issue a new stack request or special order (O.IDLE, O.DROP, O.SEEK) to ISP 
and complete the function. Call format is: 

(M.SPM, ****,****,****, EX.SPRCL) 

EX.STAT Change status. SPM is called to change ISP status in the DST and take appropriate 
action. DST status is: 

- No PP assigned. 

1 - PP assigned but not ready. PPIR - PP assigned and ready. 

When PPMTR assigns ISP to a PP, it changes the DST status from zero to one. 
After initialization, ISP issues an EX.STAT with PPIR status. This call may be issued 
again later to wake up SPM if ISP is idle and the PPMTR stack processor drop 
flag is set. A pending EDITLIB or LDCMR will set a wait flag for ISP. When ISP is 
idle and encounters the flag, ISP issues a status of one to SPM and re-initializes it- 
self. When ISP is idle and detects an outstanding channel request for its channel, it 
issues a status of zero to SPM to request a drop. SPM will then issue an O.DROP 
to ISP so that ISP can give up the PP. Call format is: 

(M.SPM, 0000, 0000, SSSS, EX.STAT) 
Where - SSSS = - Request drop 

= 1 - Request inactive status (reinitializing) 

= PPIR - Request active status (initialized) 

EX.NXTPB Get next PB/PRU. This is a time critical call made during the I/O transfer. This call 
is entered by ISP into its PPOR just prior to starting transfer of the current PB/PRU 
chunk of data. While the current chunk is being transferred, PPMTR sees the PPOR 
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call and initiates SPM. If the current transfer is a write, SPM will allocate more RBs, 
if needed. In any case, SPM then converts the current RB position in the RBT chain 
to a PB position and stores this in PPMES4, bytes 0-2 of the ISP communication 
area. When ISP completes the current PB/PRU transfer, it updates PPMES6 (current 
PB/PRU) from PPMES4 (next PB/PRU), issues the next EX.NXTPB call to the PPOR 
and continues the transfer. Call format is: 

(M.SPM, 2, SSPP, PPPP, EX.NXTPB) 

where SSPP, PPPP = Successor call type 

PPPP = - No successor call (clear PPOR) 

PPPP =£ and SS = - Set up M.BUFPTR call 

PPPP ¥= and SS =£ - Set up M.SCB call PPPP - successor call parameters. 



M.SPRCL STACK PROCESSOR RECALL 

(M.SPRCL,00AA,BBBB,000F,CCCC ) 

CCCC is the control point area address. The I/O time and PP time are updated by the product of AA*BBBB. 
The count of outstanding stack requests is modified in W.CPSR: 



F=0 


No adjustment 


F=l 


Subtract one 


F=2 


Add one 



Execution can be resumed if the control point is in recall. 



M.TRACE ENTER MONITOR TRACE MODE 

(M.TRACE,AAAA,FFFF,NNNN,****) 



AAAA Absolute address of buffer within requesting field length of 

requesting job 

FFFF Length of buffer 

NNNN Pointer to next available word-pair in buffer 
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A buffer must be provided by the trace mode requestor into which this PPMTR function will write trace 
records. Each record is a two-word entry containing function and PP status information. This function is 
reserved for CDC developmental use. 

M.TSR TERMINATE STORAGE REQUEST 

(M TSR **** **** **** ****i 

Request is valid if real time monitor is installed (IP.RTMTR is nonzero); terminates wait period involving an 
M.RSTOR request. 



PP ASSIGNMENT 

To control PP assignments, MTR keeps (in PPO) an 8-byte status word for the PP entries which form the 
PP status table. Each status word has one of two formats, depending upon whether the PP is assigned or 
unassigned and available. 



1 


2 


3 


4 


5 


6 


7 


8 


CPAD 


EXTRA 


BUFPTR 


APLINK 


JUMPAD 


PPFLAG 


PPSEC 


PPMSEC 



CPAD 

EXTRA 

BUFPTR 

APLINK 

JUMPAD 

PPFLAG 

PPSEC 
PPMSEC 



Base address of control point area to which PP is assigned. 

Spare byte. 

The low order 12 bits of the buffer pointer the last time that MTR looked 
at it (refer to M.BUFPTR). 

Active PPU link. This is a pointer to the next member in a chain of active 
PPUs. The chain always starts with MTR (PPO) and ends with DSD (PP1). 
The next PPU is identified by its output register index value. 

This is the address saved for reentry to a partially completed monitor 
function that has been exited via an RJM MAINLOOP. 

Flag is set when PP contains a stack processor (PP assigned). When idle, 
PPFLAG contains the link to the next idle PP. 

PP starting time in seconds. 

PP starting time in milliseconds. 



When the PP is unassigned and available, the PPU status word is linked in a chain of unassigned and available 
PPs, using byte 6 of the status word (PPFLAG). PP direct cell PPIA contains a pointer to the status word 
at the head of the chain. Byte 6 contains a pointer to the status word of the next available PP. If no more 
PPs are available, byte 6 contains zero. A chain of three available PPs is illustrated in figure 3-5. 
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Figure 3-5. PP Chain 

MTR assigns a PP by writing a peripheral job name and a control point number into the PP's input register 
to perform one of the following actions: 

• Satisfy a PP program call issued as an RA+1 request. 

• Answer a PP request for another PP job (M.EES or M.RPJ request). 

• Initiate a stack processor when an I/O request is issued for a mass storage device to which no stack 
processor is currently assigned. 

• Call the PP program IAJ to a control point when all control point activity has ceased. 
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MTR maintains a PP queue table containing a maximum of 40 entries, each 4 bytes long. Each entry 
corresponds to a 4-word entry in the peripheral job table (PJT) in CMR. In the queue, the following chains 
are kept: 

• A queue of PP jobs that cannot be initiated currently because PPs are not available. This PP job 
queue is a chain of PP input register images. 

• A queue of PP jobs that must be initiated after a given time delay. This queue is a time-ordered 
chain of PP register images, called the delay stack. 

• A separate queue of PP jobs for each control point which must be initiated after a specified bit has 
been set or cleared in CM. This queue is called the event stack. 

• An empty queue of all unused entries in the PP queue. 
Three pointers in MTR define the beginning of each chain: 

NPPQ PP job queue 

NACT PP delay stack 

EMPTY Empty chain 

The pointers to the event stack are in the MTR control point table EVST. Each control point has a sep- 
arate EVST. A fourth pointer, LPPQ, defines the end of the PP job queue. When ,the time delay expires 
for an entry in the delay stack, that entry will be transferred to the end of the job queue. 

Chaining of the queue entries uses byte 3 of each 4-byte entry. Bytes 1 and 2 contain the PPFLAG or the 
maturation time for entries in the delay stack. The end of a chain of entries is signaled by zeros in byte 3. 
A PP job queue containing a two-entry overload queue, a one-entry delay stack, the empty chain, and two 
one-entry event stacks is illustrated in figure 3-6. 
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Figure 3-6. PP Job Queue 
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FILES AND FILE TABLES 



FILES 

A name associated with each file identifies it to the system and to the user. Files are stored on either alloca- 
table or nonallocatable devices. Rotating mass storage units, such as disk or drum, are allocatable because 
files on these devices may be allocated to more than one control point. Other devices, such as magnetic tapes, 
card readers, punches, and line printers, are nonallocatable because they can process only one file at a time. 

Files associated with a job running at a control point are assigned or attached to a control point. Files not 
associated with running jobs are assigned to control point zero. 

Files are associated with one of the following groups: system, local, permanent, and queue. The following 
paragraphs describe briefly each of the file groups. Files are uniquely known by the lfn, the source or 
destination ID, and the terminal ID (if applicable). 



SYSTEM FILES 

The files described below are always in the system; they are always assigned to control point zero and reside 
on allocatable devices. These files, except for the job dayfile, are maintained on system devices as permanent 
files. 

SYSTEM This file has the name of ZZZZZ04 and contains a copy of the deadstart system tape. 

DAYFILE The system dayfile contains a complete record of all activity in the system. Normally when a 
message is sent to any job dayfile, it also is sent to the system dayfile. At intervals, the system dayfile can be 
dumped to a line printer, punch, or magnetic tape. 

DFILEn Each user control point in the system has a job dayfile; n is the control point number. These 

files are assigned to control point zero and a user cannot access them directly. When a user job terminates 
the content of the job dayfile is copied to the end of the job output file. A job dayfile contains images o'f all 
control cards processed, appropriate system messages concerning the job run, plus messages sent to the dayfile 
by the job. J 
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CERFILE If hardware errors are discovered by running programs, a message is written to this file. 
Periodically, the file is dumped for examination by customer engineers so they can take remedial action. 

ZZZZCMR This file contains the absolute segments of CMR in an ECS system. Depending on the options 
selected, this file is used by LDCMR at deadstart or when the system is reloaded. 

ZZZZZ06 If the installation parameter IP.ELIB is one, this file is created to contain the ECS library. 

ZZZZZ23 This file contains a copy of the CM resident library area. It is created by Deadstart and is 
updated by EDITLIB. It is not permanently attached to control point zero and is used only for deadstart 
recovery. 

LOCAL FILES 

Any files, other than permanent files, attached to a job running at a control point are local files. They may 
be on allocatable or non-allocatable devices. 

Local files assigned to a control point must have unique names. Two local files named INPUT and OUT- 
PUT are associated with each job. INPUT contains the job file; the job name is changed to the name 
INPUT when the job is assigned to a control point. OUTPUT is assigned to the job when the first reference 
to it occurs. It has a disposition code which indicates the job output is to be produced on peripheral devices 
in the area from which the user submitted the job. 

When a local file is detached from a control point, disposition depends on its control point, disposition code, 
and device type on which it resides. For local files on non-allocatable devices, the device and the related table 
space will be released. Assigned storage and related table space is released for local files on allocatable devices, 
other than private disk packs, having a zero disposition code. Files with the special names OUTPUT, PUNCH, 
PUNCHB, P80C, FILMPR, FILMPL, HARDPL, HARDPR, and PLOT are assigned non-zero disposition codes 
when created. All other files are assigned a zero disposition code when created. For local files with other dis- 
position codes the file name is changed to job name and the file is assigned to control point zero. A local file 
with the name PUNCH or PUNCHB will be output to a card punch; the file OUTPUT is printed. 



PERMANENT FILES 

Permanent files are saved across deadstarts and are therefore considered to be permanent to the system. Con- 
trols over file access and mode of use are provided to define various degrees of privacy. When a permanent 
file is created, the privacy defined determines which user can access it and the kind of processing allowed. 



4-2 60306500 F 



QUEUE FILES 

To provide for the recovery of input and output files from disk tables on non-recovery deadstarts, the input 
and output queues are kept as permanent files. All input files that enter the system via JANUS, INTERCOM 
Remote Batch processor, or load tape (n.XbTLOAD) are automatically cataloged. They are not purged until 
the job has completed execution and all output files of the job have been cataloged. When the PFC (formerly 
the RBTC) becomes full, a message is issued to the operator and input halts until there is more space for files 
to be cataloged. 

The file name table entry of queue files contains permanent file information and the file description parameters. 
1TJ is the common routine for entering a file into the input queue called by JANUS, INTERCOM Import 
processors and DSP for ROUTE(lfn,DC=IN). 2VJ verifies the job card parameters. 1QF is the PP routine which 
catalogs and purges queue files. 

INPUT QUEUE 

Jobs may enter the system from sources such as card reader, magnetic tape, or remote devices. In every case, 
a job file is read by a system package operating at a control point which then writes the job to a local file ' 
on an allocatable device. When the file has been written, its entry in the file name table is altered to indicate 
an input disposition code, the file is cataloged and released to control point zero as an input file. The input 
queue consists of all files assigned to control point zero with an input disposition code. . 

The system packages that read in batched local jobs ensure that each job file in the system has a unique 7- 
character name. The job name from the job card is truncated to the first five characters (or extended with 
zeros to five characters) and two unique sequence characters are added. All numerals atid letters may be used 
as sequence characters, therefore 1,296 sequence combinations are possible for a single five-character job name. 
Even though unique combinations are exhausted, duplication of names is not significant unless the earlier job 
has not been completely processed when the duplicate enters the system. 

OUTPUT QUEUE 

Output files originate from local files on allocatable devices; they have non-zero disposition codes. When a job 
terminates, such files are cataloged, assigned to control point zero, and given either the job name or the name 
in the file ID field of the FNT file routing supplement. These files then form a system output queue which is, 
essentially, a list of files waiting to be output to unit record equipment. 

In each output queue file name table entry, fields define the destination of the file. The characteristics that 
are defined are device type, terminal ID, destination ID, external and internal characteristics codes, disposition 
codes, and forms codes. 
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Local files can be put into the output queue as follows: 

The user gives the file a special name. When a file with a special name is created, it receives a non-zero 
disposition code. These files are sent to the corresponding destination when the file is released for output 
processing. For example, the file named OUTPUT receives a print disposition code. A file named PUNCH 
receives a punch disposition code. 

The user can specify file disposition with a DISPOSE or ROUTE control card or macro. The file can 
have any name. Files must reside on allocatable devices that are members of the QUEUE set. 

Files in the output queue must be on allocatable devices. A file is put into the output queue when the job 
terminates or when a CLOSE.UNLOAD, or CLOSE.RETURN is performed. Since the name of an output 
queue file may be the name of the job which created it, and since a job may create several files which go 
into the output queue, names in the output queue often are not unique. 

PLACING FILES IN QUEUES - ROUTE MACRO 

The ROUTE function places a file in an input or output queue. This function is available as a control card 
or as a macro. Use of the ROUTE macro allows a system job additional capabilities denied a user job. A 
system job can specify a source ID, a seven-character job name, a pre-dayfile lfn, and a priority. Other 
capabilities are the same as for user jobs. See the SCOPE Reference Manual, publication number 60307200, 
for a discussion of the ROUTE control card. 

The user must construct a parameter block in the format described below before calling the ROUTE macro. 

ROUTE tag,recall 

tag Address of the ROUTE parameter block 

recall Optional non-blank character indicating automatic recall 



PARAMETER BLOCK FORMAT 
59 47 

tag 
tag+1 

tag+2 
tag+3 
tag+4 



41 



35 



23 21 17 



11 



Logical File Name 


Error 
Code 


Unused 


A 





Forms Code/ 
INPUT Flags 


Disposition 
Code 


E 
C 




I 
C 


Flags 




Station ID- 
Source 


Station ID- 
Destination 


Unused 


TID 




File Identifier (FID) 


B 


Priority 


Pre-dayfile lfn 




Repeat 
Count 


Unused 
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Word 



Bits 



Field 



Description 



tag 



59-18 



17-12 



Logical File Name 



Error Code 



Ifn of file to be ROUTED; must be mass storage file, not 
a permanent file; does not reside on a dismountable device; 
must have at least read permission 

Code returned by system when bit 12 of flag field is set. 
A list of the error codes and diagnostic messages follows 
the description of the parameter block. 



11-1 



Unused 



tag+1 



59-48 



47-36 



Zero 



Forms Code/ 
INPUT Hags 



Complete bit. Must be zero when macro is issued; system 
sets to one when function is complete 

Twelve bits of zero. Allows compatibility with previous 
callers of DSP. The old calling sequence puts the Ifn in 
tag+1. 

Two display code letters and/or digits identifying the 
forms to be used for this file. Default is standard forms. 
If the file is to be routed to an INPUT queue, this field 
is defined as: 



35-24 





47 


Unused 




46 


Unused 




.45 • 


Do not catalog INPUT file 




44 


FID= 7 characters specified. Ignored if not a 
systems job 




43 


Send file to INPUT queue even if job card error 




42 


Use dependency count 




41-36 


Dependency count 


Disposition Code 


Disposition Code mnemonic in display code 



23-21 



EC 



External characteristics code translated by the following 
table: 



Value 






(octal) 


Print File 


Punch File 





EC(default) 


EC(default) 


1 




EC=SB 


2 


EC=A4 


EC=80COL 


3 


EC=B4 




4 


EC=B6 


EC=026 


5 


EC=A6 


EC=029 


6 


EC=A9 


EC=ASCII 


7 


Reserved for i 


nstallations 
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Word 

tag+1 



Bits 


Field 


20 


Unused 


19-18 


IC 



17-0 



Flag Bits 



tag+2 



59-42 



41-24 


Station ID- 




Destination 


23-12 


Unused 


11-0 


TID 



Description 



Internal characteristics codes transformed by the following 
table: 

IC or IC=DIS (default) - display code 

1 IC=ASCII 

2 IC=BIN - Binary 

3 Reserved 

Indicate which parameters are specified: 





17 


File name assigned by system is returned at 
tag bits 59-18 




16-15 


Unused 




14 


Repeat count 




13 


Dayfile attached for immediate route to output 
(systems jobs only) 




12 


No dayfile message, return error code in bits 
12-17 of word 1 of calling sequence 




11 


Pre-dayfile lfn specified (systems job only) 




1Q 


Forms code 




9 


Priority 




8 


Internal characteristics 




7 


External characteristics' 




6 


FID=* System appends two unique sequence 
characters to the file identifier 




5 


FID System uses FID specified in tag+3, 
bits 59-18. Only systems jobs can 
specify seven characters, other use*s 
specify five. 




4 


Disposition code 




3 


Route to remote station 




2 


TID 




1 


Route to central site 







End-of-job (deferred ROUTE) 


Station ID- 


Specified by system jobs only. The three display code 


Source 


characters 


in this field are used as the source ID for a 



job routed to an input queue. When this field is binary 
zero, the routed file has no SID. When DC=IN, the job's 
source ID is used as the setting of this field. A job's source 
ID is found in the control point area. 

Display code destination ID. The file is processed by the 
system with this logical identifier. 



Display code identifier of the INTERCOM terminal to which 
the file is sent. 
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Word 

tag+3 



tag+4 



Bits 

59-18 



Field 
FID 



17-13 


Unused 


12 


B 


11-0 


Priority 


59-18 


Pre-dayfile lfn 


17 


Unused 




« 


16-12 


REP 


11-0 


Unused 



Description 

If the calling job has not been loaded completely from 
the system library, only a maximum of five characters may 
be used to specify FID. The additional two character 
sequence number is determined by flag bits 5 and 6. Seven 
characters may be specified by calling jobs which are loaded 
completely from the system library. 



Must be set if priority is specified. 

Priority for an interactively routed output file being routed 
to the routing terminal. 



The logical file name of the file which contains the pre- 
dayfile. This parameter is only meaningful for DC=IN, and 
can only be specified by systems jobs. 



Repeat count. 



ERROR PROCESSING 

When an error occurs in processing a ROUTE macro, either a dayfile message explaining the error is issued, or 
an error code is returned in bits 17-12 of the first word in the parameter block. If the address of the param- 
eter block is outside the field length of the job or if the complete bit is set when the macro is issued, the 
job aborts. For all other errors, the ROUTE macro is not executed but processing continues. If bit 12 of the 
flag field is set, an error code is returned and no dayfile message is issued. If bit 12 is not set, a dayfile 
message is issued and no error code is returned. 

When a diagnostic is issued for the ROUTE macro, the message ERROR IN ROUTE FUNCTION LFN= is 
issued, followed by the message describing the error. 
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Error Code 
(octal) 

01 INVALID LFN - DSP 

02 CANT ROUTE NON ALLOCATABLE EQP 

03 CANT ROUTE PERM FILE 

04 NO PERMISSION TO ROUTE THIS FILE 

05 ROUTE TO INPUT NOT IMMEDIATE - IGNORED 

06 IMMEDIATE ROUTING - NO FILE - IGNORED 

07 INVALID DISPOSITION CODE - ROUTING IGNORED 

10 INVALID FID - ROUTING IGNORED 

11 DSP ABORTED BY SYSTEM 

12 DSP PARAMETER OUTSIDE FL 

13 PRIORITY SPECIFICATION IGNORED 

15 EI200 SPECIFIED - INTERCOM USED (DSP) 

16 CAN NOT ROUTE INPUT FILE 

17 DSP COMPLETE BIT ALREADY SET 

20 FILE ON DEMOUNTABLE DEVICE - ROUTING IGNORED 

21 TID NOT ALPHANUMERIC - ROUTING IGNORED 

22 FORMS CODE NOT ALPHANUMERIC - ROUTING IGNORED 

23 INVALID LINK TYPE - ROUTING IGNORED (DSP) 

24 RESERVED 

25 PRE-DAYFILE LFN AND NO DOIN - ROUTE IGNORED 

26 PRE-DAYFILE FILE NOT FOUND - ROUTING IGNORED 
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ACQUIRE MACRO 

The acquire macro calls the PP routine QAF to search the input, print, punch, special (non-standard) output, 
and execution queues looking for entries that satisfy given selection criteria. The user specifies one of four ' 
functions specified by a function code in bits 1-3 of word in the ACQUIRE parameter list : ALTER, 
modify queue entries; GET, attach a file to the caller's control point; PEEK, return information about the 
queue entries; or COUNT, count the entries in the specified queue(s). QAF can be called only by a routine 
resident in the system library. 

ACQUIRE addr,recall,N. 

addr The address of the first word of the parameter list. 

recall Optional parameter whose presence indicates recall. 

N Required parameter to distinguish this new macro from an older version. 

The file selection is based on particular parameters that describe the attributes of a file or group of files. The 
most important are file type (queue type), such as INPUT, OUTPUT, PUNCH, or special output; and priority. 

ALTER 

ALTER, function code 0, gives the user the ability to change various fields within the queue entries that match 
the selection criteria specified in the parameter list. Required parameters are queue type and the ALTER flag 
bits which indicate the actions to be performed. Optional parameters are queue entry name, address of an 
abort message, source ID, destination ID(s), terminal ID. Note that the forms code and priority fields contain 
the new values and, thus, cannot be used as a search criteria. 

The actions that can be performed are: 

a) Change routing of INPUT and/or OUTPUT queue files to the central site. 

b) Change routing of INPUT and/or OUTPUT queue files to another terminal. 

c) Change priority of OUTPUT queue files. 

d) Change forms code of OUTPUT queue files except for non-standard output (PLOT, FILM, etc.) 

e) Change repeat count of OUTPUT queue files except for non-standard output. 

f) Abort/Evict queue entries and issue supplied error message. 

The bits that indicate these actions may be set in any combination, but certain combinations are mutually 
exclusive. For example, if both a) and b) are specified, the result is as if only a) had been specified. Similarly, 
overrides all other actions. 

The user may also set the queue type bits in any combination but the combinations used when aborting a job 
can make a difference. For example, if all queue types are specified, the job is killed rather than dropped. 

GET 

GET, function code 1, selects the file that best meets selection criteria and attaches it to the control point of 
the calling routine. Required fields are: function code, priority, file type, and a zeroed completion bit. 
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Before a file is attached, a search is made to ensure that no file having the same name is already attached. If a 
duplicate file is found, an error code of 12B is returned and the completion bit is set. The search for a duplicate 
file name can be suppressed by setting the inhibit search flag. 

When the selected file is attached, an FNT supplement of type 0101B (if an input file is attached) or 0102B (if 
the attached file is output) is created and linked to the base FNT. The control point number of the job is writ- 
ten into the FNT. When the file is returned by the calling job, the FNT supplement is erased. 

After the file is attached, the complete bit is set to one, the file name and FNT address are inserted, and the 
source ID and the destination ID are entered. Should no file satisfy all the selection criteria, the complete bit 
is set to one, the FNT address is zeroed and an error code of 02B is returned. 



PEEK 

PEEK, function code 2, creates a list of three-word reply entries built from the queue entries matching the 
selection criteria. Required fields are function code, priority, zeroed completion bit, the first word address of 
the reply buffer in the user's field length where the reply entries are returned, the queue type count of the 
number of reply entries to be returned, and the queue type. Only one queue may be specified in the queue 
type. Optional queue entry selection criteria also include the starting FNT address or JDT ordinal from an 
earlier PEEK request for the same queue. 

PEEK begins examining the FNT entries at the point specified by the FNT address or at the start of the FNT 
if no address is provided. For each file that matches the file selection criteria, a three-word reply entry is built 
from the file's FNT. The reply entry is placed in the reply buffer, and the file type count is incremented by 
one. PEEK continues searching until the requested number of reply entries is found or the end of the FNT is 
encountered. The function works in a similar manner for the execution queue using an optional starting JDT 
ordinal. 

On return to the calling routine, the reply buffer, beginning at the first word address specified, contains the 
three-word reply entries. The count field for the queue type requested contains the number of reply entries 
built. The count is either the number requested or the number of entries built upon reaching the end of the 
FNT or JDT. For example: 

A user calls the QAF PEEK function to obtain 20 input queue reply entries for files having a destination 
ID of ABC. The search is to begin at FNT address 4420B, with reply entries stored in the user field 
length, beginning at REPBUF. QAF begins searching the FNT at FNT address 4420B looking for input 
queue having a destination ID of ABC. Assuming that only 15 entries are found before reaching the end 
of the FNT, the file count is set to 15, the FNT address is set to zero, and REPBUF contains 15 three- 
word input queue file reply entries built from the FNT of the 15 qualifying files. If 20 entries are found 
with the last qualified at FNT address 4730B, the FNT address is set to 4733B, ready to begin the next 
search, the input queue file count remains 20, and REPBUF contains 20 three-word reply entries. 

A special PEEK function is defined with the file type field zero. The caller may check a particular FNT entry 
at the address specified to determine whether or not the entry matches the file selection criteria. Required 
fields are function code, a zeroed completion bit, the queue type field cleared, the first word address of the 
reply buffer, and the FNT address of the file. Optional parameters are any of the file selection criteria. 

If the file at the specified address qualifies, the queue type, the complete bit, priority, etc. are inserted into 
the fields and a single three-word reply entry, built from the FNT entry, is placed in the reply buffer. If the 
file does not qualify, the complete bit is set, an error code of 02B is inserted, and the queue type field 
remains clear. 
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Format of the three-word reply entry for an input queue file is: 

57 47 41 35 29 23 



11 



Filename 


Priority 


Source ID 


Destination ID 


Reserved 


FNT Ordinal 




Job 
Dependency ID 


Dependency 
Wait Count 


Maximum 

NT 

Drives 


Maximum 

MT 

Drives 


Reserved 


Terminal ID 









Format of the three-word reply entry for an output queue (print, PUNCH, or special output) file is: 
58 53 41 23 11 



Filename 


Priority 


Source ID 


Destination ID 


Forms Code 


FNT Ordinal 


4 


Repeat 
Count 


Disposition Code 


Size of File 


Reserved 


Terminal ID 



u File Interrupt Bit 

Format of the three-word reply entry for an execution queue entry is: 

59 41 34 29 23 17 



11 



Jobname 


Not 
Used 


Priority 


Source ID 


Time 


FL/100B 


Job Ordinal 


OP ACT 


ERR 


T 
Y 


CP 


STAT 


Reserved 


TID 



Word Bits 59-18 
17-12 
11-0 

Word 1 Bits 59-42 
41-24 
23-12 
11-0 



Filename/Jobname 
Not used 
Priority 

Source ID 

Destination ID/Time left in quarter milliseconds for execution 

Forms code for output; not used for input; Job FL/100B for execution 

FNT ordinal/JDT ordinal 
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Word 2 
INPUT 



Bits 59-58 Job dependency ID 

57-48 Not used 

47-36 Dependency wait count 

35-30 Maximum number of 9-track drives to be assigned at one time 

29-24 Maximum number of 7-track drives to be assigned at one time 

23-12 Reserved for CDC 

11-0 Terminal ID 



Word 2 

OUTPUT Bits 59 



58-54 
53-42 
41-24 
23-12 
11-0 



1 means file interrupted 
Repeat count 
Disposition code 
Size of file 
Reserved for CDC 
Terminal ID 



Word 2 
EXECUTION 

Bits 59-42 

41-36 



35 

34-30 

29-24 



23-12 
11-0 



Operator action codes (SCOPE 2 only) 

Error flag values 

10B Kill 

4 Drop 

2 Rerun 

Type of job (0 = 7600 or CDC CYBER 70 Model 76; 1 = all others) 

Control point number the job currently occupies 

Job status 

70B Waiting for MMF action 

60B Waiting for pack mount 

40B Waiting for operator action 

30B Waiting for tape/device assignment 

20B Waiting for permanent file 

10B Waiting for time /event 

02B Executing 

Reserved for future TID expansion 

Terminal ID 



COUNT 



COUNT, function code 3, counts the number of queue entries of a specified type satisfying the selection 
criteria. Multiple queue type bits can be set on a single call giving the caller the count of each queue type 
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desired. Required fields are queue type, function code, a zeroed completion bit, and priority. Optional fields 
are the rest of the file selection criteria. 

The counts of the queue types specified are returned to caller, and the complete bit is set. The filename, file 
type, disposition code,- source ID, destination ID, FNT address, and priority are returned for the first file that 
satisfies the selection criteria. 



ACQUIRE PARAMETER LIST FORMAT 

QAF requires the parameter list to be at least six words in length. The list can be longer if there are additional 
destination IDs. The additional length is specified in the additional destination ID word count field. 



59 



47 



41 



35 



23 



17 



11 



5 3 



Filename 


Error 
Code 


Queue Type 


A 


B 


Alter Flags 


Forms Code 


Disposition Code 


Repeat 
Count 


FWA of Reply Buffer/ 
Message Address (ALTER) 


Source ID 


Destination ID 1 


FNT Address/ 
JDT Ordinal 


Job class 


Reserved 


TIDn 


Reserved 


TIDc 


Priority 


Pre-Dayfile LFN 


C 


D 


E 


F 


G 


Executing 
job count 


Additional DID 
Word Count 


Input File 
Count 


Output File Count 


Punch File Count 


Special Output 
File Count 


Destination ID 2 


Destination ID 3 


Destination ID 4 




^ 


Destination ID n 


Zero Terminator 





A Function Code (bits 3-1) 

B Complete bit (bit 0) 

C Pre-dayfile bit (bit 17) 

D Class 2 Input file inhibit bit (bit 16) 

E Class 1 Input file inhibit bit (bit 15) 

F Inhibit duplicate file name search (bit 14) 

G Reserved (bits 13-12) 
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Parameter List Format 



Word Bits 59-18 File Name 



If the file name of a particular file is specified on any function, each FNT 
entry is examined until the specified file name is found. This file must 
meet the specified criteria to qualify as the selected file. 



17-12 Error Code 



Code Message 

01 B Invalid queue type 

02B No queue entry found with specified parameters 

03 B Function prohibits 7777B priority 

04B No FNT space 

05B Invalid reply entry buffer address 

06B Internal QAF error on FNT address 

07B Illegal Request 

10B Too many extra DID words 

1 IB PEEK requires single queue type 

12B Duplicate file name on GET 

13B Count of zero is invalid 

14B LFN needed for file having pre-dayfile 

15B Invalid FNT address/JDT ordinal 

11-4 Queue Type 

The queue type must be supplied on all functions except the special PEEK func- 
tion when it must be zero. The binary values are: 00000001 (INPUT), 00000010 
OUTPUT), 00000100 (PUNCH) or 00001000 (special output,), or 00010000 
(execution). 

INPUT file Has a valid FNT entry, is unlocked at control point 

zero and has a disposition code of 04B (INPUT job), 
05B (INPUT tape job), or 06B (INPUT tape job on P 
display). 

OUTPUT file Has a valid FNT entry, is unlocked at control point 

zero and has a disposition code of 40B (any 501, 512, 
or 580), 41B (any 501), 42B (any 512), 43B (any 
580-12), 44B (any 580-16), or 45B (any 580-20). 

PUNCH file Has a valid FNT entry, is unlocked at control point 

zero and has a disposition code of 10B (PUNCH 026 
set from display code). 

Special output file Has a valid FNT entry, is unlocked at control point 
zero and has a disposition code of 20B (film print), 
22B (film plot), 24B (hard copy print), 26B (hard 
copy plot) or 30B (plot). 

3-1 Executing job has a valid JDT entry 

Function Code 

ALTER 

IB GET 
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2B 
3B 



PEEK 
COUNT 



Word 1 Bits 59-48 



Word 2 



47-36 

3S-24 

23 

22-18 

17-0 

Bits 59-48 

41-24 
23-12 



11-0 



Word 3 



Bits 59-36 
35-12 
11-0 



Complete Bit 

The complete bit must be cleared before any call to QAF. The bit is set on 
completion of any function. 

ALTER flags 

Bit S3 Abort/evict job/file 

52 Change repeat count 

51 Change forms code, for other functions means compare forms codes 

50 Change priority 

49 Change Terminal ID to TIDn 

48 Send to central site 

Forms Code 

Disposition Code 

Not Used 

Repeat Count 

FWA of Reply Buffer or a message to be issued when aborting a job. 
Limited to 30 characters. 

Source ID (SID) 

Destination ID 1 (DID) 

FNT Address/JDT Ordinal 

This field in the parameter list is an absolute FNT address whenever a queue 
type other than job queue is specified; It is a JDT ordinal whenever only the 
job queue is specified. The field is an FNT address and is required on a 
special PEEK function and optional on all other functions. 

Job Class 



Bit 5 
4 
3 
2 
1 




Graphics job 

Express job 

Multiuser job 

INTERCOM job 

Batch job with non-alloc device requirement 

Batch job without non-alloc device requirement 



TIDn New TID (used by ALTER only) 

TIDc Current Terminal ID (used for search) 

Priority 

If zero priority is specified and the other criteria are satisfied, GET attaches 
the first file found; PEEK writes a reply entry for each file; and COUNT 
increments the file type count. If the priority is greater than zero and less 
than 7777B and the other criteria are satisfied, GET attaches the first file 
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having a priority greater than or equal to the specification; PEEK writes a 
reply entry for each file that has a priority greater than or equal to the 
specification; and COUNT increments the file type count when a file has a 
priority greater than or equal to that specified. If the priority is equal to 
7777B, GET attaches the file having the highest priority among those that 
satisfy all requirements, PEEK and COUNT do not allow this priority and 
return an error code of 03B. ALTER does not use the priority as a search 
criteria. This value replaces whatever the entry had before if bit 50 in word 1 
is set. 

Word 4 Bits 59-18 Pre-Dayfile LFN 

The pre-dayfile logical file name is required only if the qualifying INPUT 
file has a pre-dayfile. If the file has a pre-dayfile, a separate FNT entry is 
created to describe the pre-dayfile entry. If the pre-dayfile lfn is not given, 
the complete bit is set and the error code 14B is returned. If a pre-dayfile 
lfn is always in the field, the pre-dayfile flag must be checked after each 
call to prevent duplicating the file name in the FNT entries. 

17 Pre-Dayfile Flag Bit 

16 Class 2 INPUT File Inhibit Flag 

The class 1 and class 2 INPUT file inhibit flags are used to achieve selectivity 
in terms of file classes for GET, PEEK, or COUNT functions. A class 1 file 
has no non-alloca table files associated with it. A class 2 INPUT file has at 
least one non-allocatable file associated with it. If the job card specifies 
MTxx, NTxx, or ECxxx, a non-allocatable file is associated with the INPUT 
file. If the caller sets the class 2 inhibit flag on a GET call and also sets the 
INPUT file type bit, only class 1 INPUT files are returned. 

15 Class 1 INPUT File Inhibit Flag 

14 Inhibit Duplicate File Name Search Flag 

If the flag is 1, no search is made for a duplicate file name. 
13-12 Not Used 
11-0 Executing Job Count 

Word 5 Bits 59-48 Additional DID Word Count 

The additional word count is used whenever more than one is needed in 
the parameter list. Additional DIDs are packed three per word and termi- 
nated by a byte of zeros. A maximum of 64 (decimal) is allowed. The 
count is the number of CM words required to hold the additional DIDs. 
It is not necessary to allocate an additional CM word simply to hold a 
terminating byte of zeros. To hold six additional DIDs, for a total of seven 
DIDs in the parameter list, the DID word count is two - three DIDs in 
the first word and three in the second. 
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47-36 INPUT File Count 



Only one of the four file count fields can be specified on a PEEK function; 
the other fields are not used. File type determines which file count field is 
to be used. 



35-24 


OUTPUT File Count 


23-12 


PUNCH File Count 


11-0 


Special Output File Count 


Vord 6 Bits 59-42 


Destination ID 2 


41-24 


Destination ID 3 


23-6 


Destination ID 4 


5-0 


Not Used 


Word n Bits 59-42 


Destination ID n 


41-24 


Zero Terminator 


23-6 




5-0 


Not Used 
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SUMMARY OF PARAMETER LIST USAGE 

The required and optional parameter list field usage for each QAF function and the corresponding returned 
parameters are shown below: 



Field Name 








Field Usage 












ALTER 


GET 






PEEK 


COUNT 




Call 


Return 


Call Return 


Cat 


t 


Return 


Call 


Return 


File/Job Name 





X 





X 


__ 




X 





X 


Error Code 


- 


X 


— 


X 


— 




X 


— 


X 


Queue Type 


R 


X 


R 


X 


R 




X 


R 


X 


QAF Function Code 


R 


— 


R 


— 


R 




— 


R 


_ 


Complete Bit 


R 


X 


R 


X 


R 




X 


R 


X 


ALTER Flags 


R 


- 


— 


— 


— 




— 


— 


— 


Forms Code 





— 





— 







— 





— 


DISP Code 


— 


— 





X 







X 





X 


Repeat Count 





— 


— 


X 


— 




X 


— 


— 


FWA Reply Buffer 





- 


- 


— 


R 




— 


— 


— 


Source ID 





— 





X 







X 





X 


DID 1 





— 





X 







X 





X 


FNT Add/JDT Ord 





X 





X 


O/Rtt 


X 





X 


Terminal IDn 





— 


— 


— 


— 




_ 


_ 





Terminal IDc 





— 





— 







_ 








Priority 





— 


R 


X 


R 




X 


R 


X 


Pre-Dayfile LFN 


- 


— 


-/Rt 


— 


• — 




— 


— 


— 


Pre-Dayfile Flag 


- 


— 


— 


X 


— 




X 


— 


X 


Class 2 Inhibit 





-- 





— 







_ 





_ 


Class 1 Inhibit 





— 





— 







_ 





— 


Executing Job Count 


- 


- 


— 


— 


R/- 


-tt 


X 


— 


X 


Add DID Word Count 





— 





— 







— 





— 


Input File Count 


- 


- 


- 


- ' 


R/- 


-ft 


X 


— 


X 


Output File Count 


- 


- 


- 


- 


R/- 


-tt 


X 


— 


X 


Punch File Count 


— 


— 


— 


— 


R/- 


-tt 


X 


_ 


X 


Special Out File Count 


- 


- 


- 


- 


R/- 


-tt 


X 


- 


X 


DID 2 





- 





- 







- 





- 


DIDn 





- 





- 







- 





- 


Explanation of Symbols: 





Optional Parameter 
















X 


Parameter Returned by QAF 














- 


Parameter Not Used 
















R 


Required Parameter 















t Required only if pre-day file is present. 
ttSecond symbol is for the special PEEK function. 
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VERIFYJ MACRO 

The VERIFYJ macro performs verification of basic job statement information for a new job input file. The 
job statement information is obtained from a buffer in the user's field length. This macro verifies the infor- 
mation, creates a system name for the new job, assigns the file to a queue device, and returns an FNT address 
in addition to jobname and verified status. VERIFYJ is available only to routines loaded from the system 
library. 

The VERIFYJ macro formats a call to the FP routine VEJ (verify job statement) to perform the required 
functions. VEJ can be called only by a routine resident in the system library. 

VERIFYJ has the following RA+1 interface: 



59 



42 40 



VEJ 






Tag 



"— Recall Bit 

The user must construct a parameter block in the format described below before calling the VERIFYJ macro. 

VERIFYJ tag,recall 

tag Address of the VERIFYJ parameter block 

recall Optional non-blank character indicating automatic recall 
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VERIFYJ PARAMETER BLOCK FORMAT 



47 



23 



17 



11 



Tag 



Tag+1 



Tag+2 



Tag+3 



Tag+4 



jobname* 


Error* 
Code 


Zero 


• 

C 


Unused 


Reserved 


TID 


Unused 


Buf LWA 


Unused 


Buf FWA 


FNT ADDR* 


Unused 



♦These fields are returned by the VERIFYJ macro. 



Word Bits Field 

tag 59-18 jobname 

17-12 Error Code 



Description 

The name assigned to the new job file which will be an input 
queue file once the file contents are complete. 

Status return 

Successful 

1 Job card error 

2 Buffer out of field length 

3 Reserved 

4 FNT full 

5 VERIFYJ parameter block outside FL 

6 Complete bit already set 

7 No permission to call VEJ 
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11-1 





Zero 
G 



tag+1 



tag+2 



tag+3 



tag+4 59-48 FNT ADDR 



47-0 Unused 



Error code and corresponding fields returned. 



59-24 


Unused 


23-12 


Reserved 


11-0 


TID 


59-18 


Unused 


17-0 


Buf LWA 


59-18 


Unused 


17-0 


Buf FWA 



Complete bit. Must be zero when macro used. 

On call 

1 On completion of call 



Terminal identification code 



Address of the last word + 1 in buffer of the cards to be 
verified. 



Address of the first word in the buffer of the cards to be 
verified. 

The location of the FNT for this file. The name of the file 
will be that one returned as jobname above. 



Error Code 



Fields Returned 




1 

2 
4 
5 
6 
7 



All * fields as indicated in the parameter block 

All * fields as above, except if there is a jobname error, then jobname will be ERROR xy, 
where xy is the system sequence ID. 

Only error code and complete bit. 

Only error code and complete bit. 

None - job aborted. 

Only error code - job aborted. 

Only error code and complete bit. 
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SCOPE I/O TABLES 

SCOPE coordinates the requirements of input/output files with the status of input/output devices. File tables 
and device tables are updated continually to provide interface for user jobs and system programs. 

FILE TABLES 

The status and requirements of files is kept in the following tables: File Environment Table (FET), File Name 
Table (FNT), File Information Table (FIT), and Record Block Table (RBT). The FET and FIT are created 
within the job field length; the other tables are CM resident. The CM resident tables are in the upper table 
area of CMR, except the RBT which resides at the highest addresses of CM. Detailed descriptions of CM resi- 
dent tables appear in part II, section 1. The FET and FIT are detailed in part II, section 2. 

FILE ENVIRONMENT TABLE 

Every file for which I/O is to be performed must have a FET. Each FET consists of a basic 5-word entry 
followed by additional words; the form depends on the type of I/O to be performed. 

The basic 5-word FET entry is as follows: 



FET 



FET 1 



FET 2 



FET 3 



FET 4 



59 


47 


35 


32 


Record 
Levels —, 

23 17 / 


13 


8 


I 




Logical File Name in Display Code 




Error 
Flags 


Code 
Status 


MB 


B = Busy (Free = 1) 
M = Mode (Binary = 1) 


Device Type 


Flag Bits 


Disp. Code 


LFET 
-5 


FIRST 


\ 





IN 


I Buffer 





OUT 


/ Parameters 

\ LIMIT < FL 


FNT Pointer 


RB Size 


PRU Size 


LIMIT 


I OUT < LIMIT 

/ IN < LIMIT 

OUT > FIRST 




















IN > FIRST 



LFET -5 Length of FET minus 5 words for basic entry 
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FET 5 



FET 6 



FET 7 





fwa 


Working 
Storage 




^ ES? 






UBC MLRS «• 


— Sequential Files (tape) 


Record Request/Return Info ^~f Random/Indexed 


Record Number 




Index Length 


Index fwa 


\ rues uviass storage) 



FET 5 is used for input/output blocking/deblocking by CPC 

FET S and FET 6 are used for S and L tape file processing 

FET 6 and FET 7 are used for indexed file processing by CPC; FET 6 is used to pass RMS address 
between CP programs and system PP input/output routines 

UBC Unused bit count 

MLRS Maximum logical record size (S/L tapes only) 

When the UP and/or EP flap are set in FET 1, then FET 8 contains: 



59 



47 



29 



FET 8 



17 





EOI Return Address 




Error Return Address 



When standard file labels are to be written, the following FET words are filled with information from the 
LABEL control card or macro. When a labeled file is read, the fields will contain data read from the label. 



59 



47 



29 



23 



17 



FET 9 



FET 10 



FET 11 



FET 12 



File Label Name (First 10 Characters) 


File Label Name (Last 7 Characters) 


Position Number 


Edition Number 


Retention Cycle 


Creation Date 


6-Character Multi-File Name 


Reel Number 



When LFET-5 flag in FET 1 is set to 1 for extended label processing, FET 9 has the following format: 

59 35 17 



Label Error Code 


Length of Label Buffer 


FWA of Label Buffer 
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SYSTEM FET ENTRIES 

FF.T entries for the system daylilc. the hardware error rile, and the control point dayfiies are kept in the 
upper table area ol* (.MR. adjacent to the control point zero dayfile buffer. The format of the one-word 
daytile FF.T entries is: 



59 



47 



35 



23 



11 



Index 


Buffer Size 


Rel Buf Addr 


Limit 


(unused) 



Index is the entry position relative to the table origin (T.DFB). Buffer sizes are set by SCOPE assembly 
configuration parameters internal to CMR. The origin of each buffer is found by adding the relative buffer 
address to the T.DFB origin address of the dayfile buffer area in CMR. The CP zero dayfile buffer is preset 
with a legend in the first eight words as follows: (b represents blank character) 



bDAYFILEt : 
b b b N ORM A L b 
( bbbbbbbb ) 
DEADbSTART 
s t : ! : t i i t t 
COPYRIGHTb 
CONTROLbDA 
TAbCORP. bl 
9 7 s t i t : » : 



The system dayfile area in CMR is diagrammed below: 



T.DFB 



Relative 

Buffer 

Addresses 



System FET Entries 



#£%z%z%%2^jmmz^^ 



LE.DFBO (buffer size) 



LE.DFBJ 



LE.DFB2 



LE.DFB3 



LE.DFB4 



LE.DFB5 



LE.DFB6 



LE.DFB7 



LE.CErP 



*«»2*S52%%^^ 



L.DFB 
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When the system is assembled, several system file entries are built into the FNT/FST for control point 
dayfiles, system (library) file, and hardware error file. Their initial entries are diagrammed in the following 
figure. 



- Unlocked 



/-COT 



Control Point Zero 



T.FNT 


Z 


z 


Z Z 


Z 4 D30OOO 


0— -0 


Priority 




Device 

.„TY.R!,„„ 





FWA of RBT 
Word-Pair 


Current RBT 
Word-Pair 


Cur RBT 
Ordinal 


Cur 
Syu 


Currant PRU 














7 4 


01 


Statin 






01 - Inactive 







A 


Y F 


1 L E DQOOOO 






























0— — 






. 


7 4 


— ——01 









. F 


I L 


E 




















h 
















a 






, o 


7 4 


o , , , ■ oi 









F 


I L 


E 2 000000 






























o 









7 4 


o 01 









F 


I L 


E 3 


ooooo 


Q 






























o 









7 4 


01 









F 


I L 


E 04 




-' 








■ 






o 
























7 4 


— ,01 










* 


: t 


► 







F 


I L 


E 1 5 


noooo 








T 000 

























0— — 






: 


7 4 


: 01 






c 


E 


R F 


1 LEO 


ooooo 































n 


7 4 


0_^ — ^. 1 












z 


Z 


Z Z 


Z O 3 


ooooo 


0— -, 






o --■ 










————— o 








7 4 


Q^ 1 










device l 
type } 

AX ) 


z 


Z 


z z 


Z O 8 C 


10000 


100100100100 


( LE.FNT-1 
(lintceddr 


20 










( ECS KbrarY 
< entry if 
(lP.ELIB*0 






7 4 4 


1 






LINK ) 





7 7 


4 4 4 1 








addr I 
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FILE NAME TABLE (FNT) 

To provide linkage between user programs and all I/O processing routines, SCOPE maintains the FNT in CMR 
upper table area. Each basic entry in the file name table consists of three words; one or two three-word exten- 
sions to entries may occur in some instances, extending the entry to 6 or 9 words in length. The first word 
contains the logical file name, control point number to which it is assigned, as well as other pertinent infor- 
mation. The second and third words constitute the file status information; the format differs depending upon 
the type of file and where it resides. The various forms of the FNT entry are detailed in part II, section 1 . 
The second and third words of the FNT entry are often called the FST (File Status Table) entry. 

DEVICE TABLES 

Tables in CMR that provide information on input/output equipment and channels are used by SCOPE to make 
file assignments. Tables included in this section: Equipment Status Table (EST), containing entries for all I/O 
equipment in the configured system; Device Status Table (DST) and Device Activity Table (DAT), providing 
information related to mass storage devices and controllers; Record Block Reservation (RBR) and Record Block 
Table (RBT) containing information on each record block in a mass storage device; the Dismountable Device 
Table (DDT) and Mounted Set Table (MST) containing information related to the recording surfaces. The 
Channel Status Table (CST) provides I/O channel availability information and serves as an interlock for 
major file tables, which prevents modification of the same table entry by two or more programs. Also 
included are the TAPES table and the Tape Staging Table (STG), the Device Pool Table (DPT), and the 
INTERCOM Table (ITABL). These tables are detailed in part II, section 1. 

EQUIPMENT STATUS TABLE (EST) 

The Equipment Status Table resides in the upper table area of CMR and is pointed to by P.EST in the 
CMR pointer area. Table length is variable depending upon the system configuration at deadstart. There- 
fore, the CMR pointer word also includes the LWA+ 1 address of the EST. 

The EST contains a one-word entry for each device configured in the system, including consoles and remote 
terminal MUX devices. Each entry describes current status of the device and includes the device hardware 
mnemonic name, channels to which it is attached, device unit number, etc. 

Entries in the EST are numbered starting with one; an entry number, called the EST ordinal, is used to 
identify the table position of each equipment entry. The EST ordinal of the equipment being assigned is 
given as xx in the operator type-in n.ASSIGNxx. 

The EST is the basic reference for most other I/O tables. EST ordinals are found in the FNT/FST entries 
for linking file entries to their assigned equipment. EST ordinals in the TAPES table link tape entries to 
related equipment entries in the EST. Likewise, EST ordinals are found in the Record Block Reservation 
(RBR) table, linking that table to the allocatable device it describes. 
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DEMOUNTABLE DEVICE TABLE (DDT) 

The dismountable device table is used to maintain the status of rotating mass storage devices that are logically 
removable from the system. The fixed section of the DDT is used to relate the status of an RMS drive to the 
status of the pack mounted on that drive. The variable section of the DDT is used to store pack requests that 
have not been satisfied. The second word of a fixed section entry has a pointer to the EST entry for the 
drive. Whenever the physical status of the drive changes, the EST is updated. 1RN compares the status bits in 
the EST with the status bits in the DDT and calls 1PK when a difference is detected. 1PK updates the DDT 
to reflect the new status of the drive and checks the variable section of the DDT to see if any pack requests 
can be satisfied. If a requested pack has been mounted, 1PK updates the fixed section to include the DAM 
and MST ordinals, deletes the variable section entry, and recalls the job that had requested the pack. When a 
new pack request is made, 1PK checks the DDT to see if the device is already mounted. If it is mounted, 
1PK satisfies the request. If the pack is not mounted, 1PK makes an entry in the variable section of the DDT 
and swaps the job out. 

MOUNTED SET TABLE (MST) 

The Mounted Set Table is used to keep pointers for each mounted device set in the system. Each MST entry 
has a corresponding set subdirectory table entry in the FNT. Entries are made by MNT when a master device 
is mounted and deleted by DSM when a master device is dismounted. 

DEVICE STATUS TABLE (DST) 

The stack processor uses the device status table in processing of mass storage files. The DST is located adjacent 
to the request stack in CMR upper table area. Each controller has one DST two-word entry which specifies the 
overlay to be used by the stack processor (ISP) for each controller, pointers to a chain of requests entered in 
the request stack for that controller, and device availability information. 

Each entry is numbered, starting from 1 , to identify DST ordinals. The format of a DST entry is shown in 
part II, section 1. 

In word 2, if the chain start and chain end pointers are not equal, a PP is assigned to process the stack entry 
chain. The assigned PP address is given in byte 4 of word 2; when the entry is completed and the PP is dropped, 
the byte is set to zero. 

The device status table is a key table in the processing of allocatable storage files. DST ordinals are found in 
the Device Activity Table (DAT), the Record Block Reservation (RBR) table header, and the Equipment Status 
Table (EST). A DST ordinal appears in each DST entry; it is placed into the input register of the PP assigned 
to process an entry for that device in the request stack. 

When a device is dual access type, an additional DST entry is assigned to the device. This entry immediately 
follows the first DST entry and is called the Dual Access Status word pair. The format of a Dual Access Status 
word pair is shown in part II, section 1 . 

For a dual access scheme, two ISPs can be assigned to a DST entry and share accesses to the DST entry and 
the chain of stack requests and communicate with each other through the Device Pool Table. 
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The Dual Access Status word pair is mainly used for interlocking accesses to these common tables. Also, this 
word pair is used to hold connection information for the second controller and the location and length of the 
Device Pool Table. 

Through the Unit Lock-out Table, accesses to particular units from particular controllers can be locked out 
while access is in dual mode. 

DEVICE ACTIVITY TABLE <DAT) 

The device activity table is directly related to the device status table. It has one entry for each DST entry and 
is referenced by the mass storage device open overlay (3DO) in determining the best RBR to assign to a new 
or overflowing file. 

DAT entry for a dual access scheme is followed by a dummy entry in the same way that a DST entry is fol- 
lowed by a Dual Access Status word pair. 

The formats for DAT entries are shown in part II, section 1. 



CHANNEL STATUS TABLE (CST) 

The Channel Status Table, residing in the lower table area of CMR, contains a one-word entry for each hard- 
ware channel and each pseudo channel in the system. For a reserved channel, the PP reserving the channel is 
identified in the entry. 

The channel number is obtained by a PP program from the EST entry for the type of equipment. The 
length of the CST includes entries for a minimum of 12 hardware channels (optionally 24 maximum) and 
1 3 pseudo channel numbers. 

Access to the FST/FNT/RBT is controlled by an interlock scheme which prevents two or more programs 
from attempting to modify the same table entry at the same time. Not all table accesses require pseudo- 
channel reservations. Some of the conditions which require pseudo channels are: 

Entry is added to FNT 

File is assigned to a control point, causing FNT modification 

FST code/status byte is initialized 

Details of the Channel Status Table are given in part II, section 1. 



I 
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Tables related to file processing on non-allocatable devices: 





FET 






, 


i 


FNT Pointer 








EST 


















CST 


Pointer 


FNT/FST 


















FNT Poi 


nter 




TAPES 
















STG 





EST Ordinal 



TAPES STAGING TABLE (STG! 



A satisfied job has all the tapes requested on its jobcard. Unfilled demand is the sum of the jobcard reservations 
of active jobs, less the tapes assigned to them. 

The NO TAPE STATUS FLAG makes it possible to issue tape channel functions through DSD without inter- 
ference from tape status processing. Status processing is not performed if the byte is non-zero. Normal system 
operation resumes when the byte is zeroed. 

The three clocks are used, to make event triggers for automatic assignment. 

The Tapes Staging Table appears in part II, section 1. 
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TAPE DRIVE SCHEDULING 

Tape drive scheduling improves overall system throughput, particularly as it relates to tape job setup and 
execution. Automatic assignment, prescheduling, ; and overcommitment options are controlled by the value 
of IP.TSG. 



AUTOMATIC TAPE DRIVE ASSIGNMENT 

ANSI tape labels include a volume serial number (VSN) field. The user can have tape drives assigned auto- 
matically to his ANSI-labeled tapes by specifying the VSN on a VSN statement, in the REQUEST function, 
or as a parameter on the REQUEST or LABEL control statement. The VSN statement relates the external 
sticker or VSN to the logical file name and also provides information required for the tape job prescheduling 
display. When used with the REQUEST or LABEL control statements or the REQUEST function, it relates 
a VSN to a logical file name, which is relevant to equipment assignment. By itself, however, the VSN serves 
no purpose. When a VSN control statement provides the first reference to a file, a dummy FNT entry is 
set up using equipment code 64. If no subsequent REQUEST or LABEL control statement or REQUEST 
function provides additional information about the file, CIO finds the 64 equipment code in the FNT entry, 
releases that entry, and creates a default disk file. This feature does not encroach upon automatic assignment 
by label. The VSN parameter declares the tape label as either type U (full ANSI-standard label) or type Z 
(SCOPE 3 nonstandard label). The Z labels are not ANSI standard because the recording density field 
(character 12 of the volume header label) is not standard. 

For automatic assignment of unlabeled tapes, the VSN must be entered by the operator. The tape is then 
assigned automatically to all jobs naming its VSN. Y-labeled tapes do not contain VSN information; however, 
to achieve automatic tape assignment the operator can enter a VSN for a Y tape through the console. No 
automatic assignment is provided for 2MT or 2NT parameters. 



TAPE JOB PRESCHEDULING 

The tape job prescheduling display is an extension of the P-display and lists, by VSN, the tape reels required 
by each tape job. A tape job is defined as one having MT and/or NT parameters on its job card. All incoming 
tape jobs are entered in a prescheduling queue, a subset of the input queue. The purpose of having a pre- 
scheduling queue is to advise the operator of tape reel requirements and to hold jobs in abeyance until such 
reels can be obtained from the tape library. This arrangement also allows the operator some control over the 
selection of tape jobs for execution. 
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The operator communicates with the prescheduling queue through DSD type-ins and the P-display. Each 
time the P-display is requested, tape jobs having the highest priority are displayed. A job requiring tapes is 
not placed in the normal job input queue until the operator releases it with a type-in. Once released, the job 
will be considered by assignment to a control point and execution; it will no longer appear in the pre- 
scheduling display. 



JOB SCHEDULING WITH TAPE DRIVE OVERCOMMITMENT 

Job scheduling based on tape drive overcommitment assumes that a tape job does hot always need its maxi- 
mum tape requirement for the duration of the job and that most processing activity uses less than the maxi- 
mum number of drives necessary for job completion. Therefore, a job is assigned only those drives it needs 
to continue execution at any instant in time; 1 excess drives, at that instant, are made available to run other jobs. 
Such a job scheduling algorithm permits the total tape requirements of all active jobs to exceed the total 
number of drives in the installation. However, a system deadlock could occur if two or more jobs have 
unfilled tape demands in that every tape drive is assigned but no job has enough tapes to run to completion. 
Such a deadlock could be broken only by rerunning or killing one of the competing jobs. Preventing dead- 
locks is a function of tape assignment, not job scheduling, although the job scheduling algorithm includes 
some built-in deadlock prevention features. 

As part of REQUEST processing, SCOPE 3.4 provides a deadlock prevention algorithm. A potential deadlock 
exists if at least two jobs have unsatisfied tape requirements and the number of free tapes is less than the 
maximum required to satisfy any one job. Deadlock prevention refuses any tape assignment (manual or auto- 
matic) if such assignment would create a potential deadlock. 

Tape jobs could be scheduled at random without regard to tape drive availability and the deadlock algorithm 
would evade deadlocks, but the resulting refusal of tape assignments would cause operator confusion and loss 
of efficiency. Job scheduling based on tape drive overcommitment, therefore, attempts to create an optimal 
situation and deadlock prevention avoids the worst-case situations. 
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DYNAMIC TAPE DRIVE STATUS CHECKING 

Information concerning Ihe physical status of tape drive units is entered into the TAPES table and updated by 
periodic checks of unassigned units for a ready/non-ready status. This information is displayed in the top half 
of the P display. The period for status checking is set by the installation; it must be short enough to preclude 
the possibility of an operator dismounting a tape from a tape drive and mounting another without detection. 
Such periodic checking of unassigned tape drives makes automatic assignment more efficient and flexible. 



TAPES TABLE 

Initially a tape drive is set to not-ready status, as noted in the TAPES table. When a drive is made ready, the I 
TAPES table is updated with information from the tape label. (If the tape is unlabeled, this fact is noted in I 

the table.) A search is made, then, for a job that needs the tape and the tape is assigned to it, providing such 
an assignment will not cause a deadlock. This action applies to both labeled tapes and tapes qualifying as 
scratch, per IP.TSG. 

Whenever a requested tape cannot be located immediately, the requesting job is rolled out until the operator 
mounts the tape. When the tape is found, it will be automatically assigned to the requesting job and the job 
rolled back into CM to continue processing. While the job is rolled out, the operator may make a manual tape 
assignment which will cause the job to be rolled in automatically. 

Dynamic tape drive status checking permits the automatic assignment of unlabeled tapes by volume serial num-' 
ber. A VSN entered by the operator is recorded in the TAPES table; as long as that drive remains in the 
ready status, the system knows that the tape is still mounted and that it may be assigned without operator 
intervention to any job requesting that VSN. 
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RMS SET TERMINOLOGY 

All disks used in the operating system are divided into sets. The term disk includes fixed disks and removable 
packs, and is distinct from a drive which can hold different disk packs at different times. A set is an inde- 
pendent group of disks; a disk belongs to only one set and files do not overflow to another set. Any user 
may own his own set of removable disk packs. 

NOTE 

The SCOPE 3.4.3 category "private pack" no longer 
exists; it is superseded by private sets. All RMS devices 
are now allocatable (all devices can be divided among 
several jobs). 

Private sets are removable and mountable by job requests and operator action. Each member is mounted as 
needed, and members (other than the master) may be dismounted by operator typein at any point in process- 
ing; masters may be dismounted when no jobs reference them. 

Public sets remain mounted at all times and have either PF default, system, queue, or scratch attributes, or a 
combination thereof (these can all be combined in one set). Also, the members individually have SYS, PF, 
and Q attributes to further delimit file allocation. All these attributes are set by the operator at deadstart, 
and the individual devices can be given PF and Q attributes only by initialization deadstarts. 

Members of public sets may not be dismounted; however, empty members can be deleted by DELSET, and 
new members added by ADDSET. 

The system set is used for the system file and its related files created by post-deadstart use of EDITLIB and 
LDCMR, and the dayfile and CERFILE. There is no parameter on the REQUEST card to specify system. The 
user may request the system set (and VSN) by name. 

The PF default set is assigned when a file requests *PF and no setname; only the PF default set is consulted 
on an ATTACH when no SN (setname) is supplied. 

The set is assigned for special name files such as OUTPUT, PUNCH, etc.; these files may not be assigned to 
another set. Deadstart consults only the Q set to retrieve the queues. If a file is to be moved via DISPOSE 
or ROUTE, it must first be assigned to the Q set with a REQUEST(lfn,*Q) request. 

Scratch sets are unlike the other sets as several sets may have the scratch attribute. Files not assigned by 
REQUEST and not special-named (OUTPUT, etc.) are assigned to a scratch set. 

DEVICE SETS 

Every RMS device is a member of a group of devices known as a device set. Such device sets can be either 
public sets or private (user) sets. 

Each public device set is assigned one or more of the following set attributes: 

System Set This set contains system files such as ZZZZZ04, ZZZZZ23, the system 

dayfile, and the C.E. diagnostic file. 
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Permanent File Default Set This set contains permanent flies for which an alternate device set is 

not explicitly assigned. 

Queue Set This set contains the INPUT, OUTPUT, and PUNCH queue files. 

System Default (Scratch) Set This set contains non-permanent files for which a device set residence 

is not explicitly assigned. 

Device set attributes are assigned at deadstart. All four attributes must be assigned for each mainframe. Only 
the system default attribute can be assigned to more than one device set on a mainframe. 

A private device set is a group of RMS devices which can contain permanent files and be logically and physi- 
cally removed from a running system. Permanent files stored on a private device set can therefore be trans- 
ferred from one computer to another without moving the entire system. Specific attributes cannot be assigned 
to private device sets. 

Every device in either a public or a private device set can (but need not) be assigned one or more of the 
following device attributes: 

System Device This device can contain the system files given above for the system set 

attribute. The system device attribute can be assigned only to public 
devices that are members of the system set. 

Master Device The master device contains system tables relating to its device set. 

These tables include the Device Label, the PFD (Permanent File Direc- 
tory), the PFC (Permanent File Catalog), the SMT (Set Member Table), 
the DAM (Device Allocation Map), the PFT (Physical Flaw Table), and 
the LFT (Logical Flaw Table). Every device set must have a master 
device. 

Permanent File Device This device can contain files for which the REQUEST control card 

specifies *PF. 

Queue Device This device can contain files with names such as INPUT, OUTPUT, 

and PUNCH, files with non-zero disposition codes, and files for which 
the REQUEST control card specifies *Q. 

The system device attribute is assigned at deadstart; the master, permanent file, and queue device attributes 
are assigned when the device set is created. Attributes assigned to devices (except for the system device attri- 
bute) need not match the attributes assigned to the device sets of which they are members. 



SHARED DEVICE SETS 

In a dual-mainframe system, certain device sets can be shared between mainframes. Such sets must consist 
entirely of 844 devices and cannot have the system set attribute. When a device set is shared, all devices 
within that set are shared. Devices can be shared at either the unit or the controller level. The system uses 
the hardware reserve feature to reserve access to critical tables during an update; consequently, not more than 
one mainframe can access a device during this process. A pool of free space is maintained in the RBR of 
each mainframe sharing the device. Additional space is maintained in the DAM on the master device. The 
pool is replenished when it gets low, and excess is returned to the DAM. If a stack request is outstanding but all 
local space is used, the request is chained into the Device Overflow Table (DOT) contained in CMR. Permanent 
file access between mainframes is coordinated through the PFC. 
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To comprehend the functions of the various tables involved, the methods of mass storage space allocation 
must be understood. Terms are denned below: 

SECTOR: the smallest accessible physical space increment on a track of a rotating mass storage device. 

PRU: (physical record unit): the smallest amount of data a user may access; it is 64 decimal (100 octal) 
central memory words and is usually equal to 1 sector. 

RB (record block): the smallest amount of mass storage that can be allocated. An RB, defined in the RBR 
header, is several PRUs in length. 

RBR (record block reservation): a bit-coded table which indicates those RBs on a device which are 
assigned to a file, flawed (defective), or available for assignment. A 0-bit indicates that the specific RB is 
available for assignment. The number of physical record units in a standard RB (default RB size) is given in 
the following table: 







Type 


s/Device 


Default 


Device 


RMS Type 


Codes 


PRU/RB 










(decimal) 


6603-1 


DISK 


AA 


01 


** 


6638 


DISK 


AB 


02 


50 


6603-11 


DISK 


AC 


04 


** 


821 


DISK 


AL 


05 


320 


841 


DISK PACK 


AM 


06 


56 


854 


DISK PACK 


AP 


07 


4 


844 


DISK PACK 


AY 


13 


56 



INNER ZONE IS 50 PRU/RB 
OUTER ZONE IS 64 PRU/RB 
2 RBRs ARE REQUIRED 
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= 1 SECTOR 
= 1 PRU 

= 64 (10) CM Words 
= 320 (10| PP Words 



Half-Track Recording Technique 

Alternate sectors of a physical recording track on 6603 or 6638 disks are numbered consecutively; interven- 
ing sectors are numbered the same way. Essentially, one recording track is divided into two half tracks, one 
containing the odd-numbered sectors, the other even-numbered sectors. The time required to move to the 
next numbered sector is used to set up parameters and load or unload PP memory in preparation for the 
read/write of the next sector. 
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RECORD BLOCK RESERVATION TABLE 

A record block on a mass storage device is allocated to a file before any data can be written to that file. As 
data is written and a record block is filled, another record block must be assigned. Before the stack 
processor can select a record block to assign to a file, it must determine availability of record blocks. A 
record block reservation table maintained in CMR provides this information. 

Each mass storage device is represented by at least one entry in the RBR. Several RBRs can be generated 
for a single device, each describing a unique area on the device. Each entry is made up of a two-word 
header and a variable length bit table. Each bit represents the availability of the corresponding record 
block; if a bit is zero, the RB is available for assignment; if a bit is one, the RB is not available. 

The first word of each RBR header contains a 6-bit allocation style code supplied as a parameter to the RBR 
macro when the CMR is assembled at an installation. Unique allocation style codes for each RBR may be set 
by the installation; this code can be used to direct a file to the RBR with a specific RB size and/or recording 
technique. 



RECORD BLOCK TABLE (RBT) 

The Record Block Table (RBT) is file-oriented. Each mass storage file in the system has an associated RBT chain. 
The RBT, located in the highest address end of central memory, consists of word pairs which are linked forward 
to form an RBT chain for each file that exists on an allocatable device currently recognized by the system. The 
RBT expands and contracts by 100 (octal) word blocks as files are allocated and released. A maximum of 8192 
(decimal) central memory words may be assigned to contain all the RBT entries active at any one time. 

When a mass storage file is established, a two-word RBT entry is created for that file; additional entries are 
assigned and linked in a chain as the file expands and entries are needed. Each entry consists of ten 12-bit 
bytes, some are used as pointers to additional entries in the chain and to other tables. Remaining bytes in the 
entry contain the RB numbers of record blocks assigned to the file. RB numbers are placed in sequential RB 
bytes in order of their assignment. An RB number serves as the address of a bit in the RBR and DAM bit 
tables representing the availability of that record block; it is also the address of the corresponding physical 
record block on the mass storage device. RBT entries are addressed by RBT word-pair ordinals. The word- 
pair ordinals are numbered sequentially starting from the highest address in central memory. 

The CMR pointer word P.RBT contains the current size of central memory divided by 100 (octal), as well as 
the current length of the RBT in 100 (octal) word increments. The same word also contains the RBT word 
pair ordinal of the first member of the RBT empty chain. Unused word pairs in the RBT are linked together 
to form the empty chain. As record blocks are released from an evicted file, the dropped word pairs are 
linked into the empty chain. Word pairs are assigned to files from the head of the RBT empty chain and the 
new first-member word pair ordinal is entered into the CMR pointer word. The RBT channel is requested as 
an interlock before a word pair is removed from the empty chain. 
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P.RBT 



RBT Empty 
Chain Ord. 



Entry 
Ordinal 

1 



16 

24 
26 



RBT Size 
(n Blocks) 



32 

n«40 



c 



!8I 



32 



26 



24 



High 
Core 



RBT 



Word 1 of the first word pair assigned to a file contains ordinals, flags, etc. The RB bytes denote the record 
blocks assigned to the file. These bytes, initially zero, are set as each record block is assigned. The values in 
the RB bytes are RB numbers which indicate the physical address on the device and a corresponding bit in the 
bit tables. As a file expands, additional RBs are entered into the RB byte fields until the word pair is filled-; 
in this case, another word pair is assigned to the file and linked to the current word pair. If no more record 
blocks are assignable from the RBR/DAM table, an overflow condition occurs; in this case, a word pair in 
overflow format is linked into the chain, another word pair is linked to the overflow word pair, and process- 
ing continues with the remaining RB byte fields in the last link on the overflowed device set to zero. 

As a file is evicted or record blocks are dropped, the RB bytes are cleared. When an entire word pair is 
emptied, it is linked into the RBT empty chain. 

The end of a file's RBT chain is a word pair having zeros in byte of the first word. The last word pair in 
the empty chain contains all zeros. 

The interrelationship of the FNT, RBT, and RBR entries for a file assigned to an outer zone half track on a 
6603 disk is illustrated in figure 4-2. Pointers in the lower table area of CMR give the first word address of 
the FNT and the RBR area. The RBT size, in 100B word blocks, is multiplied by 40B to yield the number of 
word pair ordinals in the RBT. Multiplying any RBT ordinal by 2 and subtracting it from the LWA+1 address 
of central memory will produce the address of the word pair entry. 
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CMR 







1 










P.RBR 




FWA RBR 




RBTSize 
















P.FNT 


FWA FNT 


LWA+1 FNT 










FNT/RBT/DDT/RBR Interface 
for a Sequential File on a 
6603 RMS Outer Zone 



Figure 4-2. File Table Interfaces 
(all numbers are octal) 



4-34 



60306500 H 



When the file is established for a job, an entry is made in the FNT; and a pointer to this entry is placed in 
the job's FET for the file. The FST entry in the FNT for a mass storage file contains the RBT ordinal of 
the first word pair assigned to the file (27 in this example), and the current word pair assigned. It also in- 
cludes the RBn byte number representing the current position of the file and the current PRU number in the 
record block being accessed. RB bytes are numbered from through 7 starting with the middle byte of the 
first word of the pair. In this example, the current RBT ordinal is 52 and the RBn byte number is 1 . Byte 1 
in the first word of any file RBT word pair contains the ordinal of the DAM table entry and the MST table 
entry used by the file. The DDT has a range of DAM ordinals associated with that device. The DDT points 
to the EST; the RBR points to the EST. Thus, the RBR ordinal can be found from the DAM. 

The current record block in the file is found by using the RB number in the RBn byte of the RBT word 
pair currently being accessed. These RBT pointers are in the FST entry; the example showing word-pair 
ordinal 52, byte RBI . Only 3 bits in the FST are needed to point to one of the 8 RB bytes in the RBT 
word pair. The RB number in byte RBI is 1517 octal or 847 decimal. To find the RBR table entry, find 
the DDT entry with the same MST ordinal (5 in this example), the DAM within range (2), and the RBR 
pointing to the same EST (10). Since the first DAM fits on one PRU, the next DAM is the RBR for this 
file (ordinal 4). To find the corresponding bit in the RBR bit table, subtract one from 847 to get 846, di- 
vide by 60 to get 14 and a remainder of 6. Then the RBR bit table entry is bit 53 (59 minus the remainder) 
in the fifteenth word (fwa + 16 octal) of the bit string. To find the corresponding physical address on the 
device, subtract one from 1517 to get 1516 and apply the formulas given in Part II, section 1, under RECORD 
BLOCK TABLE ENTRY. According to the RB address format for a 6603 disk, the physical address is outer 
zone, head position 151 of head group 3, and consists of even-numbered PRUs. A byte in the RBT points 
to the last PRU written plus one; a byte in the FST points to the PRU being accessed in the current record 
block. 



INTERCOM TABLES 

INTERCOM uses word 16B of the CMR pointer area as the pointer to the INTERCOM Multiplexer Table and 
the INTERCOM pointer area. The Multiplexer Table and subtable entries contain a complete description of the 
communications equipment to be serviced by INTERCOM. The Multiplexer Table is central memory resident. 

The INTERCOM pointer and buffer area is generated when INTERCOM is initialized and is not resident when 
INTERCOM is not running in the system. This area contains pointers to the various chains in the INTERCOM 
buffer area itself. 

The INTERCOM tables are detailed in Part II, section 1. 
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WHen the file is established for a job, an entry is made in the FNT; and a pointer to this entry is placed in 
the job's FET for the file. The FST entry in the FNT for a mass storage file contains the RBT ordinal of 
the first word pair assigned to the file (27 in this example), and the current word pair assigned. It also in- 
cludes the RBn byte number representing the current position of the file and the current PRU number in the 
record block being accessed. RB bytes are numbered from through 7 starting with the middle byte of the 
first word of the pair. In this example, the current RBT ordinal is 52 and the RBn byte number is 1 . Byte 1 
in the first word of any file RBT word pair contains the ordinal of the RBR table entry used by the file. 
The ordinal points to a two-word table header in the RBR area which, in turn, points to the bit string for 
the area on the device to which the file is assigned. 

The current record block in the file is found by using the RB number in the RBn byte of the RBT word 
pair currently being accessed. These RBT pointers are in the FST entry; the example showing word-pair 
ordinal 52, byte RBI . Only 3 bits in the FST are needed to point to one of the 8 RB bytes in the RBT 
word pair. The RB number in byte RBI is 1517 octal or 847 decimal. To find the corresponding bit in the 
RBR bit table, subtract one from 847 to get 846, divide by 60 to get 14 and a remainder of 6. Then the 
RBR bit table entry is bit 53 (59 minus the remainder) in the fifteenth word (fwa + 16 octal) of the bit 
string. To find the corresponding physical address on the device, subtract one from 1517 to get 1516 and 
apply the formulas given on the bottom of figure 4-3. According to the RB address format for a 6603 disk, 
the physical address is outer zone, head position 151 of head group 3, and consists of even-numbered PRUs. 
A byte in the RBT points to the last PRU written plus one; a byte in the FST points to the PRU being 
accessed in the current record block. 



INTERCOM TABLES 

INTERCOM uses word I6B of the CMR pointer area as the pointer to the INTERCOM Multiplexer Table and 
the INTERCOM pointer area. The Multiplexer Table and subtable entries contain a complete description of the 
communications equipment to be serviced by INTERCOM. The Multiplexer Table is central memory resident. 

The INTERCOM pointer and buffer area is generated when INTERCOM is initialized and is not resident when 
INTERCOM is not running in the system. This area contains pointers to the various chains in the INTERCOM 
buffer area itself. 

The INTERCOM buffer area is in two partitions. The lower partition contains 20B-word buffers and the upper 
partition contains lOOB-word buffers. Both partitions are totally dynamic; they are assigned and released on 
demand. The large buffers are used for the INTERCOM wide band subsystem and are not present if INTER- 
COM is not running wide band. The small buffers are used for all data transfers except wide band, and the 
small buffers are always present if INTERCOM is in the system. 

The INTERCOM tables are detailed in part II, section L 
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INPUT/OUTPUT 



I/O PHILOSOPHY 

Input and output request processing depends upon the source of each request. Active user CM programs issue 
RA + 1 requests for I/O which are cycled through CPMTR. PP programs request I/O by placing a monitor re- 
quest into their PP output register. System programs, which run at control point N.CP + 1, cannot make mon- 
itor requests through RA + 1. Since they run as CM service functions for PP programs, they make such re- 
quests through the output register of the PP servicing the program. 

CPMTR assigns the I/O request to CP.CIO which, in turn, assigns it to the proper processor, CIO or ISP. CIO 
(circular input/output) processes requests for magnetic tape, Teletype, and unit record I/O; and ISP (stack 
processor) processes all requests for mass storage I/O. 

Another I/O processor, JANUS, exists in SCOPE, but its function is limited to processing unit record I/O for 
the system input and output queues. The queues contain job input and output files and are related to the 
job processing activities of SCOPE. JANUS is discussed under the job processing section of this manual. 

CIO 

The circular input/output processor consists of the central memory program CP.CIO, the PP program OV.CIO 
and several PP I/O drivers. A system programmer can write his own input/output software, or he can have 
his program generate a call to CIO. Before calling CIO, the program must set up circular buffer parameters 
and the CIO operation code in the file environment table (FET) for the file. The relative address of the FET 
is placed in the CIO call. 

A PP routine places a CIO call in its PP output register; MTR passes it through the CP input register for the 
CP.MTR. A CP program places a CIO call in the CP request register (RA+1). When MTR accepts the CIO 
call, it assigns a PP and clears byte of the PP output register. 

When CP.MTR detects a CIO call, it passes it to CP.CIO for validation and selection of the proper CP.CIO 
routine to supervise execution of the function. The CIO call is then reissued via the request stack and 
CP.MTR to be processed by the required CIO driver; RA+1 is cleared. When the I/O operation is completed, 
CP.CIO adds one to the code/status field of FET word one. As all CIO codes placed in the FET code/ 
status field are even numbers, an odd number in that field signals completion of the operation (or that the 
file is not busy). 
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Figure 5-2. Device Set I/O Processing 
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SCOPE CIO COPES (3.4) 

All codes indicated, by * are illegal; all reserved codes are illegal. All codes are octal for coded mode 
operations; add 2 for binary mode. Example: 010 is coded READ, 012 is binary READ. 



000 


RPHR 


054 


* 


130 


CLOSE,NR 


004 


WPHR 


060 


UNLOAD 


134 


* 


^qio 


READ 


064 


* 


140 


OPEN 


014 


WRITE 


070 


RETURN 


144 


OPEN WRITE 


020 


READSKP 


074 


* 


150 


CLOSE 


024 


WRITER 


100 


OPEN.NR 


154 


* 


030 


* 


104 


OPEN WRITE.NR 


160 


OPEN, 


034 


WRITEF 


110 


POSMF 


164 


* 


040 


BKSP 


114 


EVJCT 


170 


CLOSE.UNLOAD 


044 


BKSPRU 


120 


OPEN,NR 


174 


CLOSE,RETURN 


050 


REWIND 


124 


* 







200 Series for Special Read or Write (reverse, skip, nonstop, rewrite, and so on) 



200 


READC 


230 


* 


254 


* 


204 


WRITEC 


234 


REWRJTEF 


260 


READN 


210 


READLS 


240 


SKIPF 


264 


WRJTEN 


214 


REWRITE 


244 


* 


270 


* 


220 


* 


250 


READNS 


274 


f- 


224 


REWRITER 











300 Series for Tape OPEN and CLOSE 



300 

304 * 

310 * 

314 * 

320 * 



OPEN,NR 



324 


* 


354 


* 


330 


CLOSER 


360 


* 


334 


* 


364 


# 


340 


OPEN 


370 


CLOSER.UNLQAP 


350 


CLOSER 


374 


CLQSER,RETURN 



400 Series (Reserved for CDC) 

500 Series (Reserved for Installations) 

600 Series 



600 * 

604 * 

610 * 

614 * 

620 * 

624 * 



630 


* 


634 


* 


640 


SKIPB 


644 


* 


650 


* 



654 


4 


660 


* 


664 


* 


670 


* 


674 


* 



700 Series (Reserved for CDC) 
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CIRCULAR BUFFER 

A circular buffer is a temporary storage area in central memory through which data passes during I/O 
operations. It is termed circular because I/O processing routines treat the last word and the first word of the 
buffer area as contiguous. 

FIRST is the first word address of the circular buffer. Routines that process I/O never change the 
value of FIRST. 

LIMIT is the last word address + 1 of the buffer area. No data is stored in this word. When LIMIT 
is reached, the next address accessed is FIRST. Routines that process I/O never change the value of 
LIMIT. 

OUT is the next location from which data is removed from the circular buffer. CIO or the calling 
program changes OUT depending on whether the operation is read or write. 

IN is the next location into which data is written. CIO or the calling program changes IN depend- 
ing on whether the operation is read or write. When IN = OUT-l, the buffer is full. A partly filled 
buffer extends from OUT to IN- 1 . 



FIRST 




Space for Data 




IN 



OUT 



FIRST 



LIMIT-1 



LIMIT-1 



Space for Data 




Space for Data 
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Circular Buffer 




The circular buffer must be at least one word larger than the length of one PRU. For a write operation, at 
least one PRU of data should be in the buffer. For a read operation, the buffer must have room to receive 
one PRU of data. Less than one PRU may be transmitted only if an end-of-record is read or written. 

CIO OPERATION 

When MTR initiates CP.CIO to perform file I/O, CP.CIO locates the FNT for the file, If the FNT pointer 
in the FET is non-zero, CP.CIO checks the FNT entry indicated by the pointer to determine if the file name 
in the FNT entry is the same as the file name in the FET; it will also check that the file is assigned to the 
job control point. If the names do not match or if the FNT pointer is zero, CP.CIO will search the entire 
FNT for a file assigned to that job control point with a matching name. If the file is not found, CP.CIO will 
create a FNT entry for the file. Such files are always local and assigned to allocatable devices. Once the 
FNT entry is found or created, CP.CIO stores the address of the FNT entry in the FET. The FNT pointer 
in the FET facilitates the FNT search. 

If file status is busy, CP.CIO posts the request for rescheduling and exits. Otherwise, CP,CIO checks (he 
code field in the FET against the last code/status field in the FNT to ensure the requested operation can 
legally follow the preceding operation. If not, CP.CIO replaces the RA + 1 call with a request for the PP 
program CEM which handles error messages, then reissues the RA+1 call to be processed again by 
CP.MTR. If the operation is legal, CP.CIO transfers the gode/status field in the FET to the last code/status 
field in the FNT. The proper CP.CIO routine is selected to supervise function execution. 
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When the file is opened, CP.CIO determines if the file is on an allocatable or nonallocatable device or is 
ECS resident by checking the device code in the second word of the FNT. If the file is ECS resident, an 
ECS extension routine is called to process the request. If the file is on an allocatable device, CP.CIO calls 
CP4ES which calls SPM to enter the request in the I/O request stack in CMR. The stack processor (ISP) 
schedules I/O on allocatable devices; it will perform the I/O and set the completion bit. OV.CIO and its 
overlays process I/O requests for files on nonallocatable devices. 

When OV.CIO is required, MTR assigns an available PP and causes OV.CIO to be loaded and initialized. 
Depending upon the operation, OV.CIO will call one or more of the following overlays. 



Function routines: 



1CL 

10P 

1TO 

IMF 

1RP/2RP 

1TF 

2TB 

3 DO 

3IC 

3IF 

31L 

3IM 

310 

3IV 

4ES 
6WM 



File close (nontape files) 
File open (nontape files) 

Tape open 

Multifile positioning - 

Reel close - EOR processor 

Move tape forward (except long record .(L) tapes). 

Move tape backward (except long record (L) tapes) 

Mass storage device file open 

File close for MTS tapes 

Multifile positioning for MTS tapes 

Slave for 310, 3IC, and 31V 

Write error message for MTS tape 

Tape open for MTS tapes . 

Reel close - EOR processor for MTS tapes 

Enter stack request (mass storage 1/0) 
Write error message 



Tape Drivers: 



1 IT 

IRS 
1RT 

1MT 
1NR 

1NW 
1WS 
1W1 

1R9 
1W9 
ITS 
21A 
21B 
21C 
2ID 
21L 
21R 
21W 



Main MTS tape driver, calls the nix overlays 

Read 7-track stranger (S) tapes 

Read- 7-track SCOPE standard labeled tapes 

Read/write oilier tapes (7-track) 

Read 9-track stranger (S) tapes 

Write 9-track stranger (S) tapes 

Write 7-track stranger (S) tapes 

Write 7-track SCOPE standard labeled tapes 

Read 9-track SCOPE standard labeled tapes 
Write 9-track SCOPE standard labeled tapes 
Tape sampler 
L tape read - MTS 'tapes 
L tape write - MTS tapes 
Coded SCOPE read (7-track) - MTS tapes 
Coded SCOPE write (7-track) - MTS tapes 
Label read/write - MTS tapes 
Normal read - MTS tapes 
- Normal write - MTS tapes 
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Unit record drivers: 



2PC 
2RC 
2LP 

Tape error recovery drivers: 

1P1/3PM 

1P2 

1P3/3PO 

1P4/3PS 

1RV 

1R2 

1R3 

1NO 

1N2 

1N3 

1CS 

1CT 

1CR 

3IE 

31R 

3IW 



On line card punch 
On line card reader 
On line printer 



Write error recovery - tape LGR positioning driver 

Write error recovery — erase/rewrite driver 

Write error recovery - verification driver 

Write error recovery - final LGNR positioning driver 

Initialize/terminate read error recovery 

Read parity error recovery 

Read error recovery — reposition/reread 

Noise error recovery — read error processing 

Noise error recovery — read recovery driver 

Noise error recovery — skip noise record 

Write CM data - 7/9 track stranger tape read recovery 

Write CM data - 7/9 track SCOPE standard tape read recovery 

Write CM data - 7-track other tape read recovery 

Error diagnosis - MTS tapes 

Read recovery - MTS tapes 

Write recovery - MTS tapes 



If the file device code is for a non-allocatable device, CIO loads an I/O driver into its PP to perform the 
actual I/O. The overlay selected is determined by the operation requested. For example, if a user issues a 
request to read data from a file on a SCOPE standard format 7-track tape, CIO will call the overlay 1RT 
into its PP. 1RT will reserve one of the hardware channels connected to the equipment. It then issues the 
function codes to connect the controller and tape drive. 1RT issues functions to transmit one PRU of data 
from the tape drive over the data channel, 

1RT accumulates the PRU of data in a PP buffer. When the entire PRU is transmitted or an end-of-record 
(short PRU) is encountered, 1RT picks up the pointers to the circular buffer in central memory from the 
FET. IRT continues to transfer PRUs of data from the tape through the PP buffer to the circular buffer 
until the buffer is full or an end-of-record is encountered. IRT updates the PRU count in the file FNT, 
releases the channel, sets completion bits in the FNT and FET, and drops out. 

The following charts depict the logical sequence of events during various CIO tape operations. 
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READ 



1. Exit if not enough room in buffer for one 
maximum size physical record. 

2. Exit if not enough room in buffer for MLRS 
words. 

3. Read one physical record into PP. 

4. Read one physical record into CM. 

5. If physical record exceeds maximum allow- 
able, return error status DEVICE CAPACITY 
EXCEEDED and perform error procedures. 

6. If physical record exceeds maximum logical 
record size, return error status DEVICE 
CAPACITY EXCEEDED and perform error 
procedures. If a long record is encountered, 
excess information is discarded without noti- 
fication to user. 

7. If end-of-file mark was read, perform end- 
of-file mark procedures. 

8. If noise records encountered, go to 3. 

9. If parity error, perform parity procedures. 

10. If end-of-tape reflective spot was encountered 
and tape is unlabeled, perform end-of-reel 
procedures. 

11. If short PRU was read, strip level number. 

12. If zero length PRU was read, go to 21. 

13. When 6681 is present, convert data in PP 
from BCD to display code. 

14. When 6681 is present, convert data in CM 
from External BCD to display code. 

1 5. Convert 1 632 line terminator to 0000. 

16. Transmit data to CM. 

17. Update IN. 



*////* 
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READ (Continued) 



WjMl 




18. Fetch OUT from CM. „ 

19. Place in word 7 of FET the number of un- 
used bits in the last data word. 

20. If full PRU, goto 1. 

21. If last record was level 17 of tape mark, set 
end-of-f ile status. 

22. Set end of record in status field of FET and 
exit. 
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READN 








/ °* 


/ ** 


/ "^ 


/ *■' 


1. 


Fetch si/eof MLRS from word 7 of FET. 


X 


X 


X 


X 


2. 


Exit if not enough room in circular buffer for one logical 
record plus header word. Buffer size must be > C(record) 
+ 1 (header) to avoid OUT = IN when buffer is full. 


X 


X 


X 


X 


3. 


Read one physical record into PP. 


X 


X 






4. 


Read one physical record into CM. 






X 


X 


5. 


If physical record exceeds maximum allowable, return error 
status DEVICE CAPACITY EXCEEDED and perform error 
procedures. 


X 


X 






6. 


If logical record exceeds MLRS, return error status DEVICE 
CAPACITY EXCEEDED and perform error procedures. 






X 


X 


7. 


If end-of-file (tape mark) was read, perform end-of-file 
mark procedures. Go to 18. 


X 


X 


X 


X 


8. 


If noise records encountered, go to 3. 


X 


X 


X 


X 


9. 


If parity error, perform parity procedures. 


X 


X 


X 


X 


10. 


If end-of-tape reflective spot was encountered on unlabeled 
tape, perform end-of-reel procedures. 


X 


X 


X 


X, 


11. 


When 6681 is present, convert data in PP from BCD to 
display code. 




X 






12. 


When 6681 is present, convert data in CM from BCD to 
display code. 








X 


13. 


Transmit data to CM. 


X 


X 






14. 


Update IN in PP memory. 


X 


X 


X 


X 


15. 


Place in buffer header word, length of record and number 
of unused bits in last data word. 


X 


X 


X 


X 


16. 


• pdate IN. 


X 


X 


X 


X 


17. 


Fetch OUT. 


X 


X 


X 


X 


18. 


If last record was tape mark, set end-of-file status and exit. 


X 


X 


X 


X 


19. 


Go to 2. 


X 


X 


X 


X 
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REAOSKP 



'ft/fit 



1. Read one physical record into PP. 

2. If physical record exceeds maximum allow- 
able (512 CM words, etc), return error status 
DEVICE CAPACITY EXCEEDED and per- 
form error procedures. 

3. Read one physical record directly from 
tape to CM buffer, stopping without error 
when available buffer space is full. 

4. If end-of-file (tape mark) was read, perform 
end-of-file mark procedures. 

5. If noise records encountered, go to 1 . 

6. If parity error, perform parity procedures. 

7. If end-of-tape reflective spot is encountered 
on unlabeled tape, perform end-of-reel pro- 
cedures. 

8. If short PRU was read, strip level number. 

9. If zero length PRU was read, go to 10. 

10. When 6681 present, convert data in PP from 
BCD to display code. 

1 1 . When 6681 present, convert data in CM from 
BCD to display code. 

12. Convert 1632 line terminator to 0000. 

13. Transmit data to CM. If record exceeds 
circular buffer, stop without error at buffer 
full. 

14. Place number of unused bits in last data word 
in word 7 of FET. 

15. Update IN. 

16. Fetch OUT from CM. 

17. If any unused space in circular buffer, go to 1 . 
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READSKP (Continued) 



* /2> 



■///////////// 



18. If last record was full PRU, set n * 1 and 
proceed to SKIPF. 

19. If Lis less than 17, set L-0. 

20. If record was end of file mark (tape mark), 
assume level "17. 

21. If level number is less than 1, set n » 1 and 
proceed to SKIPF. 

22. If level number is less than L, set n » 1 and 
skip to first end-of-file mark (tape mark). 

23. If last record was level 17, set end-of-file 
status and exit. 

24. If last record was not level 17, return end- 
of-record status and exit. 
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RPHR 



J> 



'S//S// 



1. Sat OUT -IN. 

2. Exit if not enough room in buffer for one maximum size physical record. 

3. Read one physical record into PP. 

4. If physical record exceeds maximum allowable, return error status DEVICE 
CAPACITY EXCEEDED and perform error procedures. If a long record is 
encountered, excess information is discarded without notification to user. 

5. If end-of-file mark was read, perform end-of-file mark procedures. 

6. If noise records encountered, go to 3. 

7. If parity error, perform parity procedures. 

8. If zero length PRU was read, go to 1 3. 

9. Transmit data to CM. 

10. Update IN. 

11. If last record was level 1 7 or tape mark, set end-of-file status. 

12. Exit. 



x 
x 
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WRITE 



1. Exit if not full PRU. 

2. If data from OUT to IN exceeds maximum 
logical record size from FET, return DEVICE 
CAPACITY EXCEEDED and perform error 
procedures. 

3.' Fetch number of unused bits in last data 
word from FET and adjust record length. If 
record length constitutes a noise record, 
return DEVICE CAPACITY EXCEEDED and 
perform error procedures. 

4. Read one PRU of data starting at OUT from 
CM to PP. 

5. Read data contained between OUT and IN 
from CM to PP. Adjust by unused bit count. 

6. When 6681 present, convert display code to 
BCD in PP memory. 

7. Whan 6681 present, convert from display 
code to BCD in CM. 

8. Convert zero byte line terminator to 1632. 

9. Write record to tape. 

10. Write, from CM to tape, data contained be- 
tween OUT and IN, adjusted by unused bit 
count. 

1 1 . When 6681 present, convert data in CM buf- 
fer back to display code. 

12. If parity error, perform parity procedures. 

13. If end-of-tape reflective spot, perform end- 
of-reel procedures. 

14. Update OUT. 

15. Exit. 

16. Fetch IN from CM. 

17. Gotol. 



WM/7777/i 



$ 



x 

X 



X 
X 



X 
X 
X 
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WRITER 



I 



'WW/i" 



t 




1. If IN - OUT, exit. 

2. If PRU not full, insert level number in PP 
buffer. 

3. If data from OUT to IN exceeds maximum 
logical record size from FET, return DEVICE 
CAPACITY EXCEEDED and perform error 
procedures. 

4. Fetch number of unused bits in last data 
word from FET and adjust record length. 
If record length constitutes a noise record, 
return DEVICE CAPACITY EXCEEDED 
and perform error procedures. 

5. Read one PRU starting at OUT or between 
OUT and IN, whichever is smaller, from CM 
to PP. 

6. Read data between OUT and IN from CM 
to PP. Adjust by unused bit count. 

7. When 6681 is present, convert display code 
to BCD in PP memory. 

8. When 6681 is present, convert display code 
to BCD in CM. 

9. Convert zero byte line terminator to 1632. 

10. If IN ■ OUT, write zero length record. Go 
to 12. 

1 1 . Write record to tape. 

12. Write data between OUT and IN from CM to 
tape, adjust by unused bit count. 

13. When 6681 is present, convert data in CM 
buffer to display code. 

14. If parity error, perform parity procedure. 

15. If end-of-tape reflective spot, perform end- 
of-reel procedures. 

16. Update OUT. 

17. Exit. 

18. If full PRU is not written, exit. 

19. Gotol. 



x 

X 



X 
X 

X 
X 



X 
X 



X 
X 

X 
X 



X 
X 
X 



X 
X 
X 



X 
X 
X 



X 
X 

X 
X 
X 
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WRITEF 




1. If no data from OUT to IN, go to 20. 

2. If ho data from OUT to IN. go to 1 7. 

3. If not full PRU, insert level number. 

4. If data from OUT to IN exoaadt maximum 
logical record size, return DEVICE CAPA- 
CITY EXCEEDED and perform error pro- 
cedure*. 

5. Fetch number of unused bits in last data 
word from FET and adjust record length. 
If record length constitutes e noise record, 
return DEVICE CAPACITY EXCEEDED 
arid perform error procedures. 

6. Fetch one PRU of data starting at OUT or 
data between OUT and IN, whichever is 
smeller, from CM to PP. 

7. Read data contained between OUT and IN 
from CM to PP. Adjust by unused bit count 

8. When 6681 is present, convert display code 
to BCD in PP memory. 

9. When 6681 is p r ese n t, convert display code 
to BCD in CM. 

10. Convert zero byte line terminator to 1632. 

11. Write record to tape. 

12. Write data between OUT end IN from CM to 
tape, adjust by unused bit count 

13. When 6881 is present, convert data in CM 
buffer to display coda. 

14. If parity error, perform parity procedures. 

16. If end-of-tape reflective spot, perform end- 
of -reel procedures. 

16. Update OUT. 



x 
x 



X 
X 



X 
X 



X 
X 



X 
X 



X 
X 



X 
X 
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WRITEF (Continued) 



J///*** 



*// -" 



17. Write end-of-f Me mark and exit. 

18. If full PRU is not written, write zero length 
level 17 record and exit. 

19. Go to 3. 

20. If last operation was WRITE, write zero 
length PRU. 

21. Goto 17. 



x 
x 
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WRITEN 




1. If OUT = IN, exit. 


X 


X 


X X 


2. Fetch header word from OUT. Set PPOUT = OUT + 1. 
Set PPIN = PPOUT + number of CM words in logical record. 
If PPIN has passed IN, exit. 


X 


X 


X 


X 


3. If data from PPOUT to PPIN exceeds maximum physical 
record size, return DEVICE CAPACITY EXCEEDED and 
perform error procedures. 


X 


X 






4. Adjust record length by number of unused bits in last data 
word (from header word). If noise record, return DEVICE 
CAPACITY EXCEEDED and perform error procedures. 


X 


X 


X 


X 


5. Fetch data contained between PPOUT and PPIN. Adjust 
by unused bit count. 


X 


X 






6. When 6681 is present, convert display code to BCD in PP 
memory. 




X 






7. When 6681 is present, convert display code to BCD in CM. 










X 


8. Write record to tape. 


X 


X 






9. Write data between OUT and IN from CM to tape, adjust 
by unused bit. 






X 


X 


10. When 6681 is present, convert data in CM buffer back to 
display code. 








X 


11. If parity error, perform parity procedures. 


X 


X 


X 


X 


12. If end-of-tape reflective spot, perform end-of-reel pro- 
cedures. 


X 


X 


X 


X 


13. UpdatePPOUT. 


X 


X 






14. Update OUT. Fetch IN. Go to 1. 


X 


X 


X 


X 
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1. If IN ■- OUT. exit. 

2. If more than 512 words in buffer, return DEVICE CAPACITY EXCEEDED to 
FET. 

3. Fetch data from OUT to IN, or 512 words from OUT. whichever is smaller. 

4. Write record to tape. 

5. If parity error, perform parity procedures. 

6. If end-of-tape reflective spot, perform end-of-reei procedures. 

7. Update OUT and exit. 
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SKIPF 



1. If n»0,setn» 1. 

2. If L is lass than 17, interpret as L equals 0. 

3. Read a physical record. 

4. If noise record encountered, go to 3. 

5. If end-of-tape reflective spot encountered 
on unlabeled tape, perform end-of-reel pro- 
cedures. 

6. If record is full PRU, go to 3. 

7. If end-of-f He mark encountered on unlabeled 
tape, assume level number equals 17. 

8. If record is not end-of-file mark, assume 
level number equals 0. 

9. If end-of-file mark encountered on labeled 
tape, perform end-of-file procedures. 

10. If level number is less than L, go to 3. 

11. Subtract 1 from n. If n ^ 0, go to 3. 

12. Return end of record to status. If last level 
number was 17, return end of file to status. 
Exit. 




*//<jf 



x 

X 



X 
X 



X 
X 
X 



X 
X 
X 



X 
X 



X 
X 
X 



X 
X 
X 



X 
X 
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SKIPS 



J 



1. If n = 0,setn = 1. 

2. If L is less than 17, interpret as L equals 0. 

3. If reel is at beginning of data (either physi- 
cal load point or zero physical record count), 
set beginning of information and exit. 

4. Read one physical record backward. 

5. If noise record encountered, go to 4. 

6. If record was full PRU, go to 3. 

7. If this is first read backward, go to 3. 

8. Position forward over short PRU. 

9. If end-of-file mark encountered, assume 
level number * 17. Otherwise, assume level 
number = 0. 

10. If level number is less than L, go to 3. 

1 1 . Subtract 1 from n. If n is not equal to zero, 
go to 3. 

12. Exit. 



'ff/Ji/f/i 



* 
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BSKP 

The BKSP function is identical to SKIPS with 

n ' * 1 and L * 0. 



BKSPRU 



wumn 



1 . If at load point or PRU count = 0, set begin- 
ning of information in FET and exit. 

2. Backspace one physical record. 

3. Subtract 1 from n. If n not equal to 0, go to 
1. 

4. Exit. 
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ALLOCATABLE DEVICE I/O 

Most files in the system are stored on allocatable units. The system library ZZZZZ04 is stored on an allocat- 
able unit known as the system device. Each time a non-CM resident CP program or a PP overlay is to be 
loaded from that library, I/O must be performed on the system device. The job and system dayfiles and the 
CE error files are stored on allocatable units, as are all input and output queue files and all files created by 
CIO. 

A request for I/O on a mass storage allocatable unit must be placed in a table, called the request stack. The 
stack is searched, and the request which will require the minimum amount of overhead to access the data is 
chosen. Overhead involves switching head groups on the disk or physically moving heads. By using a 
priority-incrementing scheme for scheduling disk I/O, overhead is kept to a minimum. 

All mass storage units are connected to controllers which are connected to hardware channels of the 
computer. For some disk devices, the controller and the disk unit form one piece of equipment. In most 
cases, however, the controller and the disk are physically separate units. All mass storage units connected to 
a single controller must be of the same type. 

READC 

The READC function is intended primarily for system use with mass storage files. Since READC uses 
inter-sector time to the maximum while reading high-speed mass storage devices, it does not include checks 
for erroneous programming and control words. READC would only be used by system programmers. 

READC lfn,recall 

READC transmits PRU's continuously to the circular buffer, with a control word preceding each PRU. 
READC is a function applicable to all mass storage devices. Reading continues until: 

Buffer does not have enough room for the next PRU and its control word. 

An error condition occurs. 

End-of-information is encountered. A 

Code and status on completion; where x depends on file mode: 

00020X Normal completion 

0ee20x Error code ee 

74123x EOI 

On mass storage, the same amount of data is transmitted for every PRU: the control word and one device 
standard PRU. The last 12 bits of the control word and the entire standard PRU length are exactly the 
physical data recorded on the device, including system control information. 
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Format of the PRU is shown below. 
59 53 47 



35 



29 



23 





PRU size 




UBC 


Byte Count 


Good Data 


lev 


Invalid Data 





PRU size 



PRU size 64 central memory words in each PRU on the device 

UBC Unused bit count; always 

Byte count Count of the number of 12-bit bytes of data. It must be equal to 5 

times the number of central memory words occupied by the data. 
The value is recorded on disk as 12 bits, but expanded here to 24 
bits. 

lev SCOPE logical record level number. If byte count divided by 5 is 

a full PRU, lev does not exist. 



The READC macro generates the following code: 
59 47 40 



29 



17 



SA1 


Ifn 


RJ 


CPC 


000003 





r 




000200 



READLS 

The READLS function is applicable only to mass storage files. READLS reads several random records into 
the file circular buffer according to the list of direct access addresses provided by the user. No information 
in the buffer will reveal boundaries. This function should be used by system programmers only. 

READLS lfn, recall 
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Before READLS is called, bits 0-17 of FET+6 should be set to the address of the list of addresses to be read. | 
Reading continues until: 

List of addresses is exhausted. 

End-of-information is encountered while reading a record. 

The buffer is full. 

An error condition occurs. 

The request is discontinued for device repositioning. 

Code and status on completion: 

Bits 3 and 4 will contain 01, 10, or 11. 10=end of record, ll=end of file; giving the status at the point 
where the operation terminated. The operation will terminate with EOI status if the last PRU of the file is 
read and no EOR or EOF occurs. The contents of bits 5 through 8 do not pertain to this description. 

The address pointer is updated by the system when a READLS terminates so that the function can be 
reissued by the user without the user changing the pointer. The updated pointer will reflect the next record 
to be read. If reading stopped in the middle of a record, the pointer will reflect the next position to be read. 

The words in the list of addresses to be read can have one of two formats, but the format of the entire list 
must be the same. A word of all zeros must terminate the list. 

Bits 36-59 contain a PRU number, the same as used in SCOPE indexes. These are the numbers the 
system returns to the record request/ return information field (bits 0-29 of word 7) of the FET 
when records are written on a mass storage device. Bits 0-35 are zero. A user list in this format will 
be converted by the system to the next format. 

Bits 0-35 contain the SCOPE internal direct access address (RBTA/RBB/PRU) address RBT. 

The READLS macro generates the following code: 
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RJ 
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CONTINUOUS WRITE (WRITEC) 

The WRITEC function is intended primarily for system use. Since it uses inter-sector time to the maximum 
on high speed mass storage devices, it does not include checks for erroneous programming and control 
words. 

WRITEC lfn,recall 

WRITEC transmits PRU's from the circular buffer to a mass storage device. Each PRU in the buffer must 
be preceded by a control word. Writing continues until: 

Buffer is empty 

An error occurs 

The diagram of the PRU and control word appears with the discussion of READC. PRU size must be stan- 
dard 64 CM words for mass storage; if not, serious errors will result. The 24 low-order bits of the control 
word and the full CM words are written to the device. 

BC is the count in 12-bit bytes of good data in this PRU and must be a multiple of 5. If BC/5 is less than 
device PRU size, then the next 12-bit byte after the good data is the SCOPE level number in binary. L must 
be in the range £ 1 <> 17 octal. 

The unused bit count field (UBC) in the header word represents the number of unused bits in the last data 
word of a PRU. Since mass storage files are in SCOPE logical record format, data resolution is to the 
nearest full CM word so that the UBC field will always be zero. This field is reserved for future expansion. 

If the file has any data at all, it must be terminated by some end-of-logical-record; the level 17 octal must 
appear as a zero-length logical record. 

The WRITEC macro generates the following code: 

59 47 40 29 
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STACK PROCESSOR 

The Stack Processor consists of the CM resident manager CP.SPM, the PP program ISP and its various overlays. 
Basically, the components of the Stack Processor and their functions are: 

CP.SPM The Stack Processor Manager 

OV.1S5 Examines DST ordinal and loads 3DO if DST ordinal = 1, other- 

wise loads ISP 

OV.1SP The Stack Processor driver supervisor 

OV.1RN Requests/releases RBT storage; merges released chains to the empty 

chain 

OV.3DO Assigns a device and an RBT word pair to a new or overflowing file 

OV.4DO Processes stack requests which require no device access - specifically 

O.SKPF/O.SKPB with skip counts of 777777B and O.BPRU. 

SPM is called to enter, terminate and reissue stack requests. It performs all RMS I/O functions except file 
assignment (3DO), non-I/O skipping (4DO), and physical I/O (ISP). Request scheduling and device optimization 
is performed by SPM. ISP is a driver and handles one request at a time. A PP or CP system routine initiates 
I/O by placing a stack request (first two words of format) in the first two words of its associated communi- 
cation area (T.PPCn for PPn) and calling the CP monitor function SPM (M.ICE/EX. SPM). SPM picks up the 
stack request from the communication area, generates the third word, puts the three-word stack request into 
the request stack area and links it to the proper DST chain. If the priority bit in the stack request is set, that 
stack request becomes the first stack request in the proper DST chain. The priority bit should be used with 
discretion; otherwise, the possibility exists that priority stack requests will be pushed down in the DST chain. 

RMS I/O is performed by SPM selecting a stack request and assigning it to a ISP driver that is assigned to a 
DST ordinal which represents an access to the specified RMS device. If, at the time a stack request is received, 
no ISP is up, the request will be entered by SPM and an M.ISP (initiate stack processor driver) request will be 
sent to MTR. If the MTR communication path is busy, no request is posted and ISP will be assigned later 
during the normal MTR DST scan for work outstanding with no PP assigned. The PP is assigned by MTR by 
using the second word of the DST as the PPIR entry to call up the proper PP routine. 

When ISP comes up, it initializes the driver by concatenating the driver code letter (from the PPIR) with the 
characters 3S to form the driver name, 3Sx, and loading that PP overlay into the driver area in the PP. Channel 
and equipment numbers are in the PPIR. Initialization is completed and SPM is called for a stack request. (A 
special procedure is used during EDITLIBs.) ISP performs the I/O requested, obtaining field access as necessary, 
and, at I/O completion, returns the stack request to SPM for termination processing. If there is another stack 
request outstanding for this driver, SPM assigns it to ISP at this time. Otherwise, it assigns the ISP to idle. 
A subsequent stack request for this driver need only be placed in this ISP's PP communication area to start 
I/O. 

The code for each driver is contained in a common deck in the program library file. The common deck and 
driver overlay names are listed below: 

Common Deck ISP Overlay Device Type 

RMSA 3SP 6603-1 disk 

RMSB 3SQ 6638 disk 
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Common Deck 


ISP Overlay 


Device Type 


RMSP 


3SS 


854 disk pack 


RMSC 


3ST 


6603-11 disk 


RMSL 


3SV 


821 data file 


RMSM 


3SW 


841 multiple disk drive 


RMSY 


3SY 


844 disk pack 



In addition to the overlay area for the driver, ISP has an overlay area for the executive routine that performs 
the other side of the data transfer or a non-data transfer related function. There are currently four such execu- 
tive routines: 

CM input/output 

PP input/output 

Positioning 

ECS I/O via CM buffers or DDP 

As each stack request is processed, the appropriate executive routine is loaded if necessary. No load occurs if 
the proper routine is already present. 

MTR insures that at least one PP contains a stack processor at all times, or that one is reserved for that pur- 
pose. This requirement is necessary so that it is always possible to load a PP overlay that resides on mass 
storage, to avoid unnecessary loading and dropping of stack processors, a stack processor will remain in the 
PP until MTR needs a free PP. At that point MTR will set a PP request flag for SPM. Idle stack processors 
check this flag in their idle loop and call SPM if it is set. SPM will then issue a drop order to the first idle 
stack processor it finds. If all stack processor PPs are busy, no action is taken until one is about to go idle. 
When the monitor drop flag is set, SPM issues a drop order to the PP instead of an idle order. 

STACK REQUEST FORMATS 

There are two kinds of stack request formats-external and internal. The external formats are those used by 
PP and CP routines in submitting I/O initiation requests to SPM through the communication area of the caller. 
The- internal format is used for SPM/ ISP communication through the ISP communication area. It is different 
from the external format because ISP does not work with record blocks (RBs) but with physical blocks (PBs). 
SPM converts RBs to PBs for ISP so that ISP will not have to access the RBT chains. 

The external stack request formats consist of three words. The first two words are supplied by the caller; the 
third word is added by SPM. The first word specifies the type of stack request (order code, interlock flag, 
direct) and source of RMS file or device information (FST pointer, RBT chain pointer, equipment pointer). 
The second word specifies the other side of the request (PP, CM, ECS). The third word is SPM internal infor- 
mation. External stack request formats are summarized in the Request Stack Entry illustration in part II, section 1. 

The internal stack request format consists of three words and is part of the SPM/1SP interface at communication 
area locations PPMES4-6. The first and third words contain the next and current PB/PRU transfer information 
in their leftmost three and four bytes, respectively. The second word and rightmost two bytes of the first word 
are as in the original stack request. The next PB/PRU information in the first word is updated by the NXTPB 
function of SPM in an overlap asynchronous fashion so that ISP can continue to do I/O and have it available 
when needed. At that point, ISP uses it to update the current PB/PRU in word three which drives ISP's current 
operation and the process is then repeated. This is done to facilitate device streaming. The internal stack request 
format is summarized in the following diagram. 
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PPMES4 


Next PB/PRU 










PB 


First 
PRU 


Last 
PRU 


PPMES5 






(As In Original Stack Request) 


PPMES6 


Current PB/PRU 


EST 
Ordinal 


PB 


First 
PRU 


Last 
PRU 


Current 
PRU 



The first and last PRU fields specify the range of the request within the specified PB and the current PRU 
is the one currently being processed. NEXT PB/PRU means the next one to be processed by ISP and in 
the case of skipping backward is the logically preceding one in the file. 

STACK PROCESSOR ORDER CODES 

Order codes used in mass storage I/O request stack entries differ from those used in the CIO code/status 
fields of FET and FST entries. The three groups of codes correspond to the formats for the second word of 
a request stack entry. Order codes and standard system symbols are given below: 

Central Memory Read/Write Orders 

00 OREAD Corresponds to READ macro, CIO codes 010 and 012. Read data from device to CM until 

(a) end of information is reached, (b) a short PRU is read, or (c) next PRU does not fit into 
the buffer.' 

01 O.RDSK Corresponds to READSKP macro, CIO codes 020 and 022. Read as for O. READ until 

(a) or (b) above, or (c) the CM buffer is completely full; then change to O.SKF with N * 1 
unless reading was stopped by (b) with record level > request level .t 



02 O.RCMPR 



No corresponding CPC macro or CIO code. Read as for O. READ but do not ttansmit 
the first n CM words of the PRU, where n is the number of CM words in the PRFX 
(77) table. Used for loading programs from a system library in which the first n words 
represent the PRFX (77) table in each record and contain information of interest only 
to EDITLIB and deadstart. 



06 O.RMR Corresponds to READLS macro, CIO codes 210 and 212. Read several, records for 

which disk addresses are given in a table; pointer to table is in FET+8. Address of 
table must be in the user's field length. Read records until EOR is reached, buffer 
capacity is exceeded, or the addresses are exhausted. 



'See logical sequence of events charts appearing earlier in this section. 
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03 O.RDNS 



Corresponds to the READNS macro, CIO codes 250 and 252. Read data from device into 
CM buffer until (a) end of information is reached, (b) a short PRU with record level 16 or 
17 has been read, or '(c) next PRU does not fit into CM buffer. Used by loader when read- 
ing a relocatable binary field, since it does not stop at an ordinary end of logical record. 



24 O.WCTNU 
O.WCTU 



20 O.RCTNU 
O.RCTU 



04 O.WRT 



05 O.WRTR 



Peripheral Processor 

10 O.RDP 

11 O.RDPNP 

14 O.WRP 

15 O.WRPR 
Positioning Orders 

12 O.SKF 

13 O.SKB 



Corresponds to WRITEC macro, CIO codes 204 and 206. Provides non-stop writing 
from CM to device without releasing/reloading PP between records. User's buffer must 
contain at least two records. Writing stops when buffer is empty. 

Corresponds to READC macro, CIO codes 200 and 202. Provides non-stop reading 
from device to CM without releasing/reloading PP between logical records. Buffer must 
provide space for at least two records and their header words. 

Corresponds to WRITE macro, CIO codes 014 and 016. Write data from CM to device until 
CM buffer contains less than a full PRU.t 

Corresponds to WRITER macro, CIO codes 024 and 026. Write data from CM until CM 
buffer is empty, ending with short PRU (zero-length if necessary) with level number spec- 
ified in request. If EOF flag bit is set, corresponds to WRITEF system macro, CIO codes 
034 and 036. Same as above, but short PRU is followed by zero-length level 17 record 
(logical end of file mark).t 

Read/Write Orders 

Same as O.READ, except read data from device into requesting PPs memory 

Same as 0.RCMPR, except read data from device into requesting PPs. memory. Used for 
loading mass storage resident PP programs and overlays. 

Same as O.WRT, except write data from requesting PP s memory to device. 

Same as O.WRTR, except write data from requesting PP s memory to device. 



16 O.BPRU 



Corresponds to SKIPF macro, CIO codes 240 and 242. Skip forward until N short PRUs 
with level > the level specified in the request have been read, or end of information is 
reached. With N * 777777, the file is positioned at end of information + 

Corresponds to SKIPB macro, CIO codes 640 and 642. Skip backward one or more PRUs 
until N short PRUs with level > the level specified in the request have been read, then move 
forward over the last of these. With N = 777777, the file is positioned at beginning of in- 
formation (rewound).''' 

Corresponds to the BKSPRU macro, CIO codes 044 and 046. Skip backward N PRUs. This 
repositioning is by physical record units rather than logical records.' 



^See logical sequence of events charts appearing earlier in this section. 
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17 O.RCHN Release allocatable storage and RBTs (processed by SPM). For permanent file set RBT 
chains, the first word pair to be evicted must be a first word pair or an overflow word 
pair. 



SPM/1SP Communication Orders (Internal Format Only) 

35 O.IDLE SPM has determined that there is no work for this ISP and that MTR is not requesting a PP. ISP 

checks the order code in its idle loop, waiting for SPM to assign a stack request. When another 
order code appears, ISP will process it. 

36 O.DROP SPM has determined that this ISP is either idle or going idle and that MTR is requesting a PP. 

ISP will drop out. 

37 O.SEEK SPM has stack requests for this ISP but none are on-cylinder. ISP will issue overlap seeks (up to 

5), monitor the units and reserve the first one to come on cylinder. (Overlap seeks may also be 
issued with other stack requests. In this case, no monitoring is done. The seeks are issued before 
stack request execution; status is taken after stack request execution and returned to SPM with 
the stack request.) 



The following table is a summary of stack processor orders: 



Octal 
Code 

00 
01 
02 
03 
04 
05 
06 
07 
10 
II 
12 
13 
14 
15 
16 
17 
20 

24 

35 
36 

37 



System 
Symbol 

OREAD 

O.RDSK 

O.RCMPR 

O.RDNS 

O.WRT 

O.WRTR 

O.RMR 

O.RDP 

O.RDPNP 

O.SKF 

O.SKB 

O.WRP 

O.WRPR 

O.BPRU 

O.RCHN 

O.RCTNU 

O.RCTU 

O.WCTNU 

O.WCTU 

O.IDLE 

O.DROP 

O.SEEK 



Order 
Function 

Read into central memory 

Read-skip into central memory 

Read into central memory, drop first 3 CM words 

Read nonstop 

Write from central memory 

Write EOF/EOR from central memory 

Read multiple records to central memory 

Not currently defined 

Read into PPU memory 

Read into PPU, drop first 3 CM words 

Skip forward 

Skip backward 

Write from PPU memory 

Write EOF/EOR from PPU memory 

Backspace n PR Us 

Evict 

Read nonstop (comparable to tape READN) 

Write nonstop (comparable to tape WRITEN) 

Wait for stack request 

DropPP 

Issue overlap seek 



STACK PROCESSOR/SYSTEM INTERFACE 

The system tables, system routines, and MTR functions used by the stack processor are described in this section. 
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TABLES 

Control Point Areas: Control point error flag, storage move flag, RA, and FL. The stack processor accesses 
but never changes these fields. 

DST: All fields of the DST entry whose ordinal is placed by MTR in the ISP input register are used. SPM 
makes all DST changes except one made by MTR during ISP assignment to a PP. 

EST: Mass storage flag, unloaded flag, off flag, and DST ordinal are checked but not altered. 

FET: Code and status field in first word, error processing flag in second word are accessed by SPM. IN and 
OUT pointers in third and fourth words are accessed by ISP. Code and status is marked busy (even value) 
before a request enters the stack and is marked complete (odd value) when the request is executed. 

FST: RBT/RB/PRU position pointers in first word, code and status field in second word are accessed by 
SPM. The code/status field has been processed the same as for the FET. 

RMSBUF: Stack processor (ISP) formats and stores RMS hardware error diagnostics in the RMSBUF three- 
word area for DSD to display. 

RST: Request scheduling table is parallel to the request stack area and is used by SPM to hold request 
scheduling parameters. 

DDT: First and last DAM ordinals, MST ordinal, and EST ordinal are all used by SPM in determining RBR 
ordinal of a permanent file set member and whether or not it is mounted. 

RBR area: All the first header word, the EST ordinal, and available RB count bytes in the second header 
I word are used by SPM. SPM assigns record blocks for a write request by searching the RBR table for avail- 
able bits. When the request is terminated or re-issued, SPM sets the corresponding bits in the RBR for all 
record blocks assigned for the write operation. SPM also clears RBR bits when record blocks are released and 
updates the available RB count. 

RBT: All fields. The pseudo channel CH.RBT is reserved only when RBT word pairs are being removed from 
the RBT empty chain. 

SCB: FIRST, IN, OUT, and LIMIT are accessed in the same manner as an FET when transferring data 
between RMS and ECS. 

R.STBMSK (PP Resident): Contains appropriate mask when calling R.STB; always returned to 7700 octal, 
its normal value. 



SYSTEM ROUTINES/PROGRAMS 

PP Programs 

1SX Stack processor auxiliary program is called by MTR request for tasks that ISP cannot 

handle or does not have time to do. For example, ISP does not issue dayfile messages, 
because if the dayfile buffer is full, ISP and MTR could loop endlessly waiting for each 
other. 
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MTR 



7ID 



System Monitor calls ISP initially (via 1S5) when a request has been made for an inactive 
DST entry and performs various functions for ISP while it is processing the request. 

Stack processor auxiliary program called by 1SX. 7ID informs the operator (via a flashing 
message at the bottom of the B-display) that the job associated with control point xx has. 
an outstanding request for an idled device. 



PP Resident Routines: 



R.DCH 
R.IDLE 
R.MTR 
R.TAFL 

R.OVL 
R.RCH 
R.STB 

RTFL 

Monitor Functions: 

M.DPP 

M.SPM 



M.RCH 

M.RPJ 
M.KILL 



Releases a channel reservation. 

Entered when ISP releases its PP. 

Used for all MTR functions other than reserve or drop channel. 

Terminates access to the control point field length. When necessary, it is used to interlock 
storage moves during execution of a request, and when a request is terminating (except at 
control point zero) to switch ISP back to control point zero. 

Loads driver overlay 3Sx. 

Reserves a channel. 

Inserts controller equipment number into device function codes and channel number into 
I/O instructions. 

Computes an absolute CM address from one that is relative to a control point's RA, and 
checks whether or not a relative CM address is within the control point's FL. 

Releases PP assignment. 

Used by ISP to call SPM. The three executives are: 

EX.SPRCL - Stack processor recall; terminate a stack request 
EX.STAT - Change status; get next stack request 
EX.NXTPB - Get next PB/PRU 

Used (rather than R.RCH) with zero in byte 4 to reserve pseudo channel CH.RBT only if 
it is immediately available. 

Used for calling 1SX to another PP. 

Used when a bad monitor request has been made. 



SPM/ ISP INTERFACE 

The PP communication area through which SPM and ISP communicate is highly structured. This area consists of 
a PP input register (PPIR), PP output register (PPOR) and a six-word PP message buffer (PPMES1-6). The PPIR, 
used to call ISP, comes directly from the second word of the DST and contains initialization information such as 
drive, name, equipment and channel number. The PPOR is used by ISP to initiate SPM via the M.SPM monitor 
call in addition to other monitor calls. PPMES1-2 are used for up to five byte pairs (corresponding bytes of 
PPMES1-2) of overlap seek information and for the 1SX error information interface. PPMES3 is for SPM internal 
information although ISP supplies the device PRU/PB count in the right-most byte during initialization. PPMES4-6 
is the internal format stack request that SPM gives to ISP. The order field in PPMES4 is monitored by ISP to 
determine what work there is to be done. 
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The format of the ISP communication area is: 



PPIR 



PPOR 



PPMES1* 



PPMES2* 



PPMES3 



PPMES4 



PPMES5 



PPMES6 



53 _____^ 


£L. ....... .. - 


3S 


29 


23 


21 


17 


11. 




a 


1 s 


P O 


Driver 
Name 


DST 
Ordinal 


E 


O 


CH 




M.SPM 




EX.xxx 


M.xxx 




Unit Ordinal 


Unit Ordinal 


Unit Ordinal 





.- 


1SX Error Information 


PB * 


PBy 


PB Z 


- 


- 


1SX Error Information 


SPM Internal Information 


PRU/PB 


Internal 


SR 
Order 


. ... .......... 


Format 


Stack Request 



•EXAMPLE SHOWS THREE UNITS SPECIFIED FOR OVERLAP SEEK WITH ZERO TERMINATOR 



STACK PROCESSOR ERROR CONDITIONS 

This section describes the error conditions that can be detected by the stack processor. In some cases, the action 
depends on debug mode. With IP.DEBUG=0, these conditions are treated similarly to other errors: an error code 
is placed in the code and status field of FET and FST entries and the control point is aborted if error processing 
(EP) bit in FET is zero. With IP.DEBUG # 0, an invalid MTR function is issued with the ISP output register 
having 77 in byte and an error code in byte 1. 

END OF INFORMATION 

Puts 01 into bits 9-13 of code/status, but does not issue a message or abort control point. (Non-fatal 
condition.) 

PARITY ERROR 

A parity error is reported when any possibly recoverable device error occurs during a read or write operation. 
These include actual parity error, lost data, and mispositioning. The PRU is reread or rewritten up to 10 



60306500 K 



5-33 



attempts (3 for ECS). Whether success is attained or not, request execution continues after setting a flag. When 
request execution is completed, or the request is about to be reissued to the stack, the flag is examined. If the 
error was recovered, 1SX is called with code 03 (dayfile message RECOVERED PARITY ERROR), but this 
condition does not affect code/status or abort the control point. If all 10 attempts fail, 1SX is called with 
code 04 (dayfile message UNCORRECTABLE PARITY ERROR), 04 is put into bits 9-13 of code/status, and 
the control point is aborted if EP bit is zero. A request at control point is not aborted. 

When an uncorrectable parity error occurs for a READ request and the EP bit is nonzero, request execution 
terminates with the bad PRU being the last one read. 

BUFFER PARAMETER ERROR 

This error occurs when a request is processed that references an FET when not all the following conditions 
are satisfied: 

£ FIRST < LIMIT S field length 
FIRST* IN < LIMIT 
FIRST <S OUT < LIMIT 

Calls 1SX with code 11B (dayfile message BUFFER ARGUMENT ERROR), puts 22B into bits 13-9 of code/ 
status, and aborts control point if EP bit is zero. 

NOT ASSEMBLED FOR ECS 

This error occurs when a request references a DST entry for an ECS device. ISP issues a bad MTR request 
(code77B). 

UNDEFINED ORDER CODE 

A request contains order code 07. Calls 1SX with code 22B (dayfile message INVALID STACK ENTRY), puts 
22B into bits 13-9 of code/status and aborts control point if EP bit is zero. 

NO FET FOR O.RMR 

A request contains order code 06 (O.RMR), but no FET was specified. Calls 1SX with code 11B (dayfile 
message BUFFER ARGUMENT ERROR), puts 22B into bits 13-9 of code/status and aborts control point 
if EP bit is zero. 

ADDRESS OUT OF FL FOR O.RMR 

Address for table of disk addresses for O.RMR is out of field length. Call 1SX with code 22B (dayfile mes- 
sage INVALID STACK ENTRY), puts 22B into bits 13-9 of code/status and aborts control point if the EP 
bit is zero. 

INTERLOCK BROKEN 

A group of interlocked stack requests were interrupted by a malfunction of a controller and/or unit. ISP puts 
24B into bits 13-9 of code/status. 
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RMS HARDWARE ERROR 

An RMS hardware error is reported when any of the following errors occur on a device: 

Unit not ready 6603-11 positioning failure 

Positioner not ready No status returned 

6681 internal/external reject Address byte not accepted 

Unit busy too long No disconnect on status request 

Channel stays active after 'connect' or 'function' Abnormal on seek 

Unable to connect Channel not active after ACN 

These error conditions are reported by ISP (via a flashing message at the bottom of the B-display). The 
function on which the error condition occurred is retried until it is recovered or until the device is idled down 
by the operator (in either case, the error diagnostic is cleared). If the device is idled, 22B is returned to bits 
13-9 of code/status and 7ID is called. The operator is notified of the job name associated with the idled 
equipment (via a flashing message at the bottom of the B-display). 1SX is called when the operator acknowl- 
edges the message (message is also sent to the dayfile), and the control point is aborted if the EP bit is zero. 



DEMOUNTABLE PACK PROCESSING - I/O DETAIL 

Figure 5-1 shows the flow of control of disk I/O, including the processing of dismountable devices. 

NORMAL CALLS FOR READ/WRITE 

The user requests I/O by calling CIO in RA+1. CIO calls 3DO if the file is new to assign it to a specific 
pack as discussed below under SPM. If it is an existing assigned disk file, CIO loads 4ES which: 

performs random positioning 

generates the stack request which accomplishes the function 

issues the function to SPM via the PP resident routine R.EREQS 

SPM processes all stack requests. Some system routines (JANUS, overlay loads, batch terminals) send requests 
directly to SPM rather than use CIO. SPM performs release-chain functions except for those file segments 
which are not on-line. 

SPM first determines if the function is a read or write function and whether the current segment of the file 
is on-line. If the function is a normal write (not REWRITE), SPM assigns RBs to the file based on the 
amount of data in the buffer; if there is no space in the file and no free space in the current RBR, SPM 
sends the request to 3DO. When the write completes and too much space has been assigned, SPM is again 
called to remove any extra RBs. 

SPM next determines which DST this disk belongs to and adds the request to that DST's chain. MTR en- 
sures that a stack processor or a DST is active by checking the DST chain pointers; if there is no activity, 
MTR activates ISP. 
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Path of normal read/write calls 

Normal RBTs, M.ICE, and over lavs 
— — — Generate went which activates program in event stack 
r a= Put program in event stack 
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explicit f 1£V 

chain evicts 



Figure 5-1. Device Set I/O Processing 
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ISP processes I/O to an arbitrary point, for example, to a cylinder boundary, and then may re-issue the 
request to SPM. ISP always returns the request to SPM if the DAM ordinal in the RBT changes; thus the 
ordinal 777 in overflow wordpairs always causes a request to return to SPM, and then to 3DO. 



SPM-3DO INTERFACE 

SPM forwards to 3DO all requests which fail at any point in the above description: BKSPRU; release-chain 
not mounted; SKBPF or SKIPS with count=777777B; file is new and has no RBTs (hasn't been assigned); 
position is at an overflow wordpair (DAM=777B); etc. 3DO masquerades as the stack processor for the first 
DST, which is reserved; actual disk controllers begin at the second DST. Thus SPM forwards 3DO requests 
via the same mechanism as normal requests by putting them on the first DST chain. 

3DO DEVICE ASSIGNMENT 

The only task of 3DO is to select a disk for files requiring space to write, such as new files. Other tasks are 
passed on. BKSPRU and SKIPF/SKIPB with count=777777B are sent to 4DO for completion. If the current 
segment of the file is not on a mounted pack, or if the function is not a write (as opposed to REWRITE), or 
if the file still has space available to write in, 1PK is called. 

If the FNT indicates a new file (no RBTs), 3DO obtains a wordpair and changes the format from new-file to 
existing file by moving the flags from the FNT to the RBT. Next, the set for the file is chosen; if SN was 
specified, no selection is made. If SN was not specified, *PF, *Q, or *SYS (*SYS is available only by macro) 
is selected as specified. If none is specified, a flag is set to indicate that a scratch set is required. 

Order of device selection: 

1. the device must belong to the required set 

2. if *PF, *Q, or *SYS, the device must also have that attribute 

3. if a device type or allocation style or VSN was specified, attempt to match it; if no match, but 
DV was specified, repeat the attempt ignoring the requirements of VSN, device type, and alloca- 
tion style. 

Selection is limited to the allowed devices. Controller and unit activity from the DAT, and available space in 
the RBR are factors in selection of the optimal device. 3DO creates an overflow wordpair (for all but new 
files) and an empty wordpair for the selected device, and re-issues the request to SPM. 3DO considers only 
mounted devices. If 3DO finds no space available and this is not a public set request, 3DO calls 1PK to 
consider selection of an unmounted member of the set. 

Once the file is written, its device set attribute is fixed. 



1PK CHOOSING AND MOUNTING MEMBERS 

1PK may be called by CIO, MNT, ADS or independently via M.RPJ. 3DO may not load 1PK via R.OVL 
because 3DO is considered a stack processor and therefore not allowed to use M.DFM or other I/O because 
it could lead to a deadlock condition. 1PK issues dayfile messages and can be accessed by 3DO only via a 



60306500 H 5-37 • 



call by M.RPJ. The calling routine places a function number in the PP input register byte 2 to specify the 
1PK function desired: 

function 6 

Calls from 3DO are always made using function 6, and 1PK is called via M.RPJ. The call from CIO for 
CLOSER is also done in this way, so 1PK must determine if CIO is called and if the function is CLOSER. 
If not CLOSER, if the function is a write (not REWRITE) and if the input register byte 4 is zero indicating 
a write at EOI, space must be assigned. Assuming 3DO checked the mounted devices, read the SMT and as- 
sign the file to a pack with available space which is not mounted, considering first the online devices, then 
those not present. If there is no space and the user has not set UP, the user is aborted with error 10 - 
device capacity exceeded. 1PK selects a device and calls MNT as an overlay. When the mount is successful, 
MNT reloads 1PK which re-issues the stack request. If the pack is not online, 1PK function 9 is put on the 
event stack with the stack request in its message buffer; see the following discussion on functions 5, 0, and 9. 

If UP is on and there is no space, complete the FET with error 10 — device capacity exceeded. If the cur- 
rent position is not online on a public set, abort the job. 

If not CLOSER and not a write, the first step is a mount. First, advance position past any overflow word- 
pair; check if required disk is mounted (if yes, re-initiate the function by calling CIO, or SPM if CIO not in 
input register); if not CIO, call MNT which will call 1PK back and the process will repeat if MNT found the 
pack online and mounted it. If not, MNT calls 1PK function 2 to swap the job out while waiting for the 
pack. When the operator puts the pack on and turns ON the EST, 1PK function 5 will be called by 1RN 
which periodically checks ON/OFF changes. Function 5 will cause the removal of all lPKs from the event 
stack which were waiting and they re-issue the stack request; MNT finds the pack online and I/O proceeds. 

CLOSER is processed by CIO calling 1PK function 6. When 1PK detects a CLOSER call, 1PK processing 
depends on whether the position is EOI. If EOI, a dummy overflow wordpair is attached on the end of the 
RBT. The DAM and VSN fields will be zero. Both EOI and EOV status are set in the FET. 

If the current position is not EOI, the file is positioned to the next EOV wordpair, or to EOI if that comes 
first. If the current position is an EOV wordpair, nothing is done. EOV status is returned to the FET if 
the new position is an EOV wordpair, or EOI if encountered. 

If MNT finds the operator dismount flag set in the SMT, it loads 1PK mode 7, which calls 1PK mode 8 with 
a delay, which re-issues the stack request. This continues until the pack goes offline or is remounted. 

functions 1. 2 

These functions are called by MNT when a required pack is not online to delay the job until the pack 
becomes available. The SN/VSN are put into the variable area of the DDT if not there. The JDT enters 
the queue with others that may be waiting on that DDT. 1PK function 9 is put in the event stack on the 
JDT swapin, and the job is swapped out by the macro CI SO. The initial PP input register from the caller is 
sent on in the message buffer. Stack requests are added to the message buffer. 

function 5 

Function 5 is called by 1RN when an EST FREE, BUSY, or OFF status changes (becomes different from the 
DDT). The fixed DDT for this EST is updated. If a pack has come online and appears in the variable-DDT 
area, 1PK function is called for each job queued on the DDT and the job is cleared. 
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functions 8, 9 

Function 8 swaps the job in. Function 9 re-initiates the I/O function. If the input register was CIO, func- 
tion 9 will re-issue it to CIQ. If not CIO, the stack request is in the message buffer and is re-issued to SPM. 



REMOVING A PACK - DELSET AND DSMOUNT 

Both DELSET and DSMOUNT can be used to make a disk unavailable to the system. DELSET removes a 
disk from set membership and requires that there be no files on it. DSMOUNT makes a disk unavailable to a 
job; operator dismount, DMNT, permits the operator to remove a pack from a drive. DELSET uses PP rou- 
tine DLM; DSMOUNT and DMNT use PP routine DSM. 

DLM and DSM must halt all stack request activity before a disk may be removed from mounted status. To 
do this, they set the request-idle bit in the EST; 1PK checks the stack request area for requests for this unit, 
and if it finds none, sets the EST status to FB=1 1 to indicate there is no activity; then any subsequent re- 
quests for the pack cause the requesting job to be swapped, and DLM or DSM can put the pack into unavail- 
able status. 

DELSET removes a disk from a set by zeroing its entry in the SMT (which defines set membership). Before 
this is done, DLM searches the RBT for local files and the PFC for permanent files resident on this disk, and 
checks that the SMT usable count matches the total DAM available counts (if the disk is in dismounted status). 
If any test fails, DLM aborts the job. 

A DSMOUNT call from a job (including the automatic one at end of job) decrements the set's activity and 
resets it to dismounted status if no jobs reference it. The operator typein DMNT resets the disk to dismounted 
status as soon as all I/O clears, and sets the operator dismount flag in the SMT so that no other mainframe 
may mount the disk. Only an RMNT typein or a RECOVER clears this flag. . 

An operator dismount proceeds as follows: 

If the pack is mounted on this mainframe— 

1. The EST request-idle bit is set which locks out all I/O 

2. The routine waits until all activity stops on the disk (signalled by FB being set to 11); then 
it clears request-idle 

3. If the device is not shared, the RBR is translated into a DAM and written on the disk; the 
mounted flag is cleared from this mainframe's bit in the SMT entry; the DDT is written in 
dismounted format (S.DDSN=1) 

4. If the device is shared, the RBR is simply not written to the disk. The PP reads the DAM, 
clears all bits in the DAM which are clear in the RBRs, and then writes the DAM back. 
Other processing is the same as in 3 above. 

If the pack is not mounted but is online on this mainframe, DSM simply sets the EST to FB=11. 

If another mainframe has the pack mounted, DSM terminates with an operator message that the pack 
cannot yet be removed. It sets the EST to FB=10 (free). The pack cannot now be mounted unless the 
operator enters RMNT (remount). The operator can attempt DMNT again later. 

If no other mainframe has the member mounted, DSM sets the EST to OFF and FB=Q (no pack online). 
The operator may then remove the pack. 
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ECS-BUFFERED I/O 

Reading and writing of large sequential RMS files is greatly enhanced by the use of ECS buffers. Such oper- 
ations involve the use of a small central memory buffer in the user's field length and a large user's buffer in 
ECS. The data is transferred between ECS and the RMS device either through a system circular buffer (SCB) 
in central memory or through a distributive data path (DDP). The following describes a write sequence in- 
volving an ECS buffer; a read sequence is essentially the reverse. 

The user requests ECS buffering on a file-by-file basis through the REQUEST control card or REQUEST 
macro. On the control card, the user includes an EC parameter in addition to the normal parameters in one 
of the following forms: 

EC For a default (IP.BUF) size buffer 

EC(xxxx) For a buffer of xxxx-thousand (octal) words 

EC(xxxxK) 

EC(xxxxP) For a buffer of xxxx(octal) pages. 

In the REQUEST macro, the user must set bit 33 to one in the second word of the parameter list. In the 
fourth word of the parameter list, the buffer size must be set into bits 0-1 1 and the display code character K 
or P must be set into bits 12-17. 

In a write sequence, the user first puts data into a central memory buffer, which need be only about 200 
words long, then issues a CIO call through RA + 1. If an XJ instruction follows the request in RA + 1, the 
job is exchange-jumped out of execution, and CP.MTR begins processing the request. 

CP.MTR recognizes the CIO call and passes it to CP.CIO for processing. ECS-buffered file I/O causes CP.CIO 
to perform a validity check on the FET and activates the proper ECS driver. The data is then written directly 
from the user's central memory buffer to the user's buffer in ECS. 

The above process continues until the user's ECS buffer is full, then a stack request is generated by CP.CIO, 
requesting that the ECS buffer be written to an RMS device. In processing the request, the stack processor 
ISP loads the appropriate ECS executive routines into an area of ISP memory. 

At a request of ISP for an SCB, CBM (system circular buffer manager) assigns the first one available from the list 
of SCBs. Each SCB has an integral number of PRUs so that PRUs are not split across the end of the buffer. 
When a central memory buffer path is selected, ISP uses the SCB in the normal circular I/O mode, with the fol- 
lowing modification. In addition to FIRST, IN, OUT, and LIMIT, the FET-like SCB control table also contains 
a TRIGGER and a DIRECTION field. Before the transfer, ISP puts an M.SCB in its PPOR. During the transfer, 
MTR checks to see if the trigger has been reached. If so, it calls CBM to process the SCB; if not, no action is 
taken. This circular I/O continues until the ECS buffer has been emptied and all data has been written out to 
the RMS file. The processing is designed to prevent ISP from missing disk revolutions during an I/O buffer 
transfer. 

When the distributive data path is selected, the processing is very similar. CP routines do the same bookkeepping 
as in the central memory case, but only point to the data in ECS instead of transferring it to central memory. As 
a result, much less central memory is used for the transfer: N words instead of 65 xN words for an SCB contain- 
ing N PRUs. 
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The following illustrates the general flow of output to an ECS buffered RMS file. Either data path may be 
assigned dynamically, depending on availability. 



Central 
Memory 
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PERMANENT FILES 



A permanent file is a mass storage file cataloged so that its location and identification are always known to the 
system. The installation designates rotating mass storage devices to contain files made permanent by the user. 
When creating a private device set. a user can designate permanent file devices. Any file, regardless of content, 
which is not already permanent and which resides on a permanent file device, may be made permanent by 
explicit request. Files on magnetic tape or I£CS may not be made permanent. 

In a multi-mainframe envirornent, permanent files may be transferred between linked mainframes. The MMF 
station is used to stage files between mainframes. 

PERMANENT FILE FUNCTIONS 

The following permanent file functions are available as system macros: 



CATALOG 

SAVEPF 

ATTACH 

GETPF 

RENAME 

EXTEND 

PURGE 

ALTER 

PERM 

FDB 



an existing local mass-storage file, thereby making it a permanent 
file. 

stage out a local copy of the file and catalog the file. 

a previously cataloged file to a control point. 

stage in a local copy of the permanent file. 

a file in the permanent file directory. 

a currently attached file by making permanent an extension to it. 

a file from the permanent file directory. 

allows the logical end-of-file to be set to the current file position, 

allows a running program to determine what permissions haye 
been granted to an attached file. 

generates a file description block required for interface with the 
permanent file system. 



In addition, two SCOPE system macros and control cards may be used on an attached permanent file to 
logically detach it prior to job completion. 

macro: CLOSE Ifn, UNLOAD or CLOSE Ifn, RETURN 

control card: RETURN (Ifn) or UNLOAD (Ifn) 
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MACRO REQUESTS 

| Hie permanent tile functions CATALOG, SAVEPF. ATTTACH, GETPF, RENAME. EXTEND, ALTER, and 
PURGE are available either as control cards or running program macro calls. The same parameters are used 
for both; they differ in the call format and in the capability to test status in the running program. 

All permanent file macro requests share a common format: 

name fdbaddr.RC.RT,NR 

name Macro name written in a COMPASS instruction mnemonic field 

fdbaddr Address of fifth word in a file definition block (FDB) 

RC,RT,NR Optional parameters 

RC Returns a code to the FDB and gives control 

to the requestor on non-fatal errors. 

RT Returns a code to the EDB and inhibits per- 

manent file queuing. (Queueing occurs when 
a file cannot be attached immediately.) 

NR Specifies no recall. (All permanent file macro 

calls, are issued in recall unless NR is 
specified.) 

Error messages will be written to the job dayfile, unless the RT or RC parameter is specified. 

PARAMETERS 

The parameters described below are common to both control cards and macro functions. With the excep- 
tion of Ifn and pfn, parameters may be given in any order. Each is written in the form: cc = value or 
password where cc is a two-letter parameter code. The Ifn and pfn parameters are position dependent; if 
one or the other is omitted, the Ifn and pfn are considered to be the same string of characters. In the case 
when a pfn contains more than 7 characters in the parameter, the Ifn will be the first 7 characters given in 
the pfn. 

Ifn Logical file name; 1-7 character alphanumeric name (first charac- 

ter alphabetic) by which a file is known and referenced at a con- 
trol point. Once a permanent file is attached to a control point, it 
is referenced by this name. 

pfn Permanent file name; 1-40 alphanumeric characters, assigned by 

file creator, under which a file is cataloged. 

RP Retention period in days, (0-999) specified by creator; indefinite 

retention indicated by 999. Installation default value is defined by 
the installation. 
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AC Account parameter; 1-9 letters or numbers. 

C Y Cycle number (1-999) assigned by creator. Default value on initial 

CATALOG is 1, and on ATTACH, the highest number cataloged. 

LC Lowest cycle number cataloged is referenced when value given is 

non-zero; default is highest number cataloged. 

PW List of passwords used to establish user's access permission. Writ- 

ten as: 

PW-psw.,psw 2 ,psw 3 psw n 

PW also is used in a CATALOG request when a new cycle is 
added or PUBLIC file created, and in a PURGE request in per- 
manent file name mode; up to five -passwords allowed, each 1-9 
letters or numbers. 



TK 


Turnkey \ 




CN 


Control I 




MD 


Modify f 


Password definition 


EX 


Extend / 


1-9 letters and numbers 


RD 


Read \ 




XR 


Common / 





MR If non-zero, gives read permission only which will permit read 

access of the file by other users. 

RW If non-zero, multi-read with single rewrite will be allowed. If zero, 

and either CN, MD or EX permission is requested, exclusive access 
will be given. 



ID Identifies file creator; 1-9 tetters and numbers. The ID name PUBLIC 

is reserved for PUBLIC files, and SYSTEM is reserved for SYSTEM 
files. 

ST Staging ID; three letters and numbers that specify logical ID, Host ID 

or link ID. The staging ID identifies the mainframe where the file 
resides. When both ST and SN appear, ST takes precedence and SN 
is ignored. 

FO File structure (ordering of data) is checked so that extend and modify 

permissions will have meaning for direct access (DA), actual key (AK), 
or indexed sequential (IS) files. Applies to Record Manager files only. 

RB If nonzero and S.PCRB in PFC entry is set, PURGE will not allow 

the mass storage associated with the file to be released. RB is used 
when the routine RECOVER has encountered RBT chain conflicts 
with other files. 
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EC Allocates ECS for permanent file I/O buffer. 

EC=»K Allocate a standard number of IK blocks. 

EC m nnnn Allocate an octal number of 1 K blocks. 

EC = nnnnK Same as above. If K is omitted and P is not 

given, K is assumed. 

EC «• nnnnP Allocate an octal number of ECS pages. 

SN Device set name 1-7 letters and digits, first character a letter. If 

specified on an ATTACH or PURGE, the specified permanent file 
resides on the device set. 



STAGING ID 



The staging ID, ST, identifies the mainframe where the file resides. It may be either a linked mainframe or 
the local mainframe that is executing the calling routine. The host ID (local mainframe), the link ID (linked 
mainframe), or a logical ID may be specified for ST. 

When the host or the link ID is specified and the station is running, the local or the linked mainframe is given 
the task of satisfying the file request. When a logical ID is specified, the task is assigned to the mainframe 
having that ID in its logical ID table. 

Example: 

Three system files, FILEA, FILEB, and FILEC normally reside at mainframe A, MFA, but occasionally 
will be moved to mainframe B, MFB. 

A user who knows the physical location of the files can set the ST parameter (on a GETPF, SAVEPF, 
or PURGE) to the proper value (example, ST»MFB) before submitting a job. 

By using a logical ID in the ST parameter, however, the routine could remain the same no matter 
where the fife reside. The installation would associate these three files with a logical ID, such as ABC. 
The caller then would specify ST=ABC and mainframe having ABC in its logical ID table would be 
assigned to the task. 

UNIVERSAL PERMISSION 

An installation may define a combination of one or more permissions to be granted automatically by 
activating the universal permission option (IP.UP), A nine-character password is defined by the installation 
for such a permission combination. When this password is given on an ATTACH request, the permissions 
are granted. 
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PUBLIC FILES 

If the public permission password is correctly specified, a file may be cataloged under the ID of PUBLIC; 
then the user can omit the ID parameter on all permanent file requests. Attaching a PUBLIC file does not 
preclude the necessity of using correct permission codes. 

As all cycles of a file share the same ID, when the first cycle of a file is cataloged as PUBLIC, all subsequent 
cycles will become PUBLIC. With the RENAME function, a PUBLIC file can be given a new owner ID. 
making it a private file. 

MACRO REQUEST CALLS 

Each permanent file request macro expansion (except FDB) will generate an RA+ 1 call to the permanent 
file PP program. All permanent file macro requests are issued with recall status set (bit 40 in word 2 of the 
request) unless NR (no recall) parameter is present in the macro call. 

An RA + 1 call to a permanent file PP program has the following format: 



59 


39 


17 


PPProgram Name 


a 


fdbaddr 



a = If the NR parameter is present in the macro call. 

a - 1 If the NR parameter is not present in the macro call. 

FILE DEFINITION BLOCK 

Parameters necessary for the execution of a permanent file function are contained in a central memory table 
called the file definition block (FDB). Error codes are returned to the user via the FDB. The FDB is generated 
automatically for control card calls, but it must be generated by an FDB macro for use by other permanent 
file macro calls. The format of the FDB is shown in part II, section 2. 1 
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The macro for generating an FDB has the following format: 

fdbaddr FDB lfn,pfn.parameters 

| fdbaddr is the symbol associated with word 4 of the FDB; it must be 

present in the location field. 

parameters are separated by commas, and the list is terminated by a blank. 

Parameters include any of the 2-letter parameter codes listed 
above. Parameters are entered into the FDB as they are encoun- 
tered in the list. 

The FDB is generated in-line during assembly whenever the macro is called. 

If the RC and RT parameter is specified in a macro call, a return code will be available to the user in word 
| 4, fdbaddr, bits 9-17. 

Word 4, bits 0-8, contain the PFM request code stored in the following format: 



Bit 


Content (when set) 




8 


NR option given 




7 


RT option given (implies RC given also) 


6 


RC option given when bit is zero; no RC or R 


5-2 


Function code 






0010 


ATTACH, GETPF 




0100 


CATALOG, SAVEPF 




0110 


EXTEND 




0111 


ALTER 




1000 


PURGE, PURGE^T^xxx) 




1010 


RENAME 




1100 


PERM 



I Not used 

Functioh completed when set to one 

Request code examples (octal): 

020 Catalog; return error code and control to user on non-fatal error. 

1 30 Extend file; abort job on any error. 

210 Attach file; return error code on any error and inhibit file queuing. 
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Word 4, bits 9-17, contain a 9-bit return code which can assume the following octal values; the associated 
message is written to the job dayfile. 



SX). 
00. 



000 Function successful 

001 ID error 

002 lfn already in use 

003 Unknown lfn 
04 No room for extra cycle (limit is five) 

005 Permanent file catalog (PFC) full 

006 No lfn or pfn 

007 (not used) 

010 Latest index not written for a random file 

011 File not on PF device 

012 File not in system 

013 Archive retrieval aborted 

014 Bad LPF communication 

015 ' Cycle number limit reached. Maximum value of cycle number is 999 

016 Permanent file directory (PFD) full 

017 Function attempted on non-permanent file 

020 Function attempted on non-local file 

021 (Not used) 

022 File never assigned to a device 

023 Cycle incomplete or dumped 

024 File already attached 

025 File unavailable 

026 (Not used) 

027 Illegal lfn 
030 File dumped 
031-032 (Not used) 

033 ALTER needs exclusive access 

034 (Not used) 

035 File already in system 

036 (Not used) 

037 (Not used) 

041 Device set not mounted at control point 

042 RBT chain too large for PFC 
043-067 (Not used) 

070 PFM stopped by system 

071 Incorrect permission 

072 FDB address invalid 

073 I/O error on PFD/PFC read/write 

074 ST parameter illegal with private device set (MMF-PURGE) 

On control card requests, all errors are fatal; on macro requests, unless an RC or RT parameter is specified, 
all errors are fatal. If RC or RT is specified on a macro call, an error code will result in control being returned 
to the user. Any job that attempts a privacy breach is terminated. 

On control card or macro requests for GETPF, SAVEPF, or PURGE(ST=xxx), all errors are fatal. The job is 
terminated and an error message is written to the job dayfile. 
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The parameter words of the FDB have the following format: 
59 




As shown above, parameters are stored, one per word in any order. Parameter code values are placed in bits 
0-5. The format of values entered in the parameter field is indicated in parentheses in the following list. 

00 End of FDB list 

02 RP Retention period in days (binary) 

03 CY Cycle number (binary) 

04 TK Turnkey password (display code) 

05 CN Control password (display code) 

06 MD Modify password (display code) 

07 EX Extend password (display code) 

10 RD Read password (display code) 

11 MR Multi-read access only (binary) 

13 XR Control, modify, and extend password definition 

(display code) 

14 ID User identification (display code) 

16 AC Account parameter (display code) 

17 EC Request ECS buffering of I/O (display code) 
20-24 PW Submitted passwords (display code) 

25 FO File organization (display code) 

27 Used internally for checkpoint/restart 

31 LC Lowest cycle (binary) 

32 ST Staging ID 

33 RW Multi-read with single rewrite 

40 SN Setname (left justified, display code) 

41 Reserved for VSN parameter 
43 RB PURGE RB conflict parameter 
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CATALOG FUNCTION 

CATALOG rdlMddr.RC.K1.NR 

For this request, the required parameters in the FDB are ll'n, pfn and ID. If the permanent file name is 
unique to the ID specified, the request is considered an initial catalog. The initial catalog defines the 
passwords necessary to access any of up to 5 cycles that may be cataloged with the same pfn and ID. If 
there is no CY parameter specified, it is assumed to be ■ I. The following parameters are relevant on an 
initial catalog: 

CY Cycle number 

XR Control, modify, extend, common password definition 

CN Control password 

MD Modify password 

EX Extend password 

RD Read password 

TK Turnkey password 

RP Retention period 

FO File validity check 

RW Read with rewrite permission 

MR Multi-read access 

PW Password list 

AC Account parameter 

If a file with the same pfn and ID has already been cataloged, the request will be considered a new cycle 
catalog. If a CY parameter is not specified, it is assumed to be one larger than the highest cycle. Control 
permission must be established to do a new cycle catalog. The following parameters are relevant on a new 
cycle catalog: 



CY 


Cycle number 


PW 


Password list 


RP 


Retention period 


FO 


File validity check 


RW 


Read with rewrite permission 


MR 


Multi-read access 



If RC is specified, the user is notified of a non-fatal error condition by an error return code at fdbaddr in 
the FDB. 

If RT is specified, the call is regarded as real-time. Specifying the RT option forces the RC option. In both 
cases, informative and diagnostic messages to the dayfile are suppressed. 

Initial Catalog Example: 

FDBA FDB LF1 ,MFII.E,CH-Z,MD-X,TK-Y, ID-ABC 



CATALOG FDBA.RC 

LF1 is assumed to exist on a valid permanent file device as a local file to this control point. 

60306500 F 6-9 [ 



The CATALOG macro references FDBA which contains the necessary parameters to make LFI permanent. 

Since RC is specified on the CATALOG macro, control will he returned to the user on a non-fatal error; 
and a return code will be made available in location FDBA (bits 9-17), If RC is not specified, all errors 
result in termination and a diagnostic message. 

New Cycle Catalog Example: 

CATALOG FOB 5 



*DB5 FDB LF16, MFILE, CY-12.PW-Y.Z, ID-ABC 

This job will add a second cycle to permanent file MFILE, created in the preceding example. File LFI 6 is 
assumed to be a valid local file on a permanent file device. The PW parameter is used to submit the 
passwords needed to obtain control permission. Had the initial catalog attempt aborted, MFILJE would not 
exist; and this new cycle attempt would be processed as an initial cataloging. If successful as an initial 
catalog, the file would be unprotected as no passwords are defined in the FDB. An alternate form of the 
FDB could be used: 

y °B5 FDB LF16, MFILE, CY-12 .PW-Y.Z, ID-ABC, TK-Y,CN-Z,MD-X 

The above FDB would perform equally as well for a new cycle, catalog because the TK, CN and MD 
parameters'would be ignored. If initial cataloging had failed, this FDB would catalog the file with protec- 
tion and the PW parameter list would be ignored. 

SAVEPF FUNCTION (multi-mainframe only) 

SAVEPF fdbaddr,RC,RT,NR 

The SAVEPF request requires the lfn, pfn, ED and ST parameters in the FDB. The optional parameters are 
the same as those for the CATALOG function. Refer to the CATALOG function for more details. 

SAVEPF stages a local file specified by the lfn to be cataloged at the mainframe associated wiht the ST param- 
eter. The mainframe where the file is to be cataloged may be either a linked mainframe or the local mainframe. 
In both cases, two files exist after the call: a new or updated permanent file and the local file attached to the 
calling routine. 
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ATTACH FUNCTION 

ATTACH fdbaddr.RCRT.NR 

The ATTACH request requires the lfn, pfn and ID parameters in the FDB. The following parameters are 
optional: 

CY Cycle number to be attached. 



PW 


Password list 


MR 


Multi-read access 


LC 


Lowest cycle number 


RW 


Multi-read/rewrite access 


EC 


ECS buffering for I/O 


SN 


Setname 



RC parameter is the same as for CATALOG. When RT is specified, a code of 25 is returned to the FDB if 
the file is currently in use. If the RT parameter is not specified, the following circumstances will cause a job 
issuing an attach request to be queued for the desired file: 

File not available for exclusive access by requesting job 

Attached permanent file (APF)table full 

Archived file temporarily unavailable. The ATTACH request will cause a LOADPF job to be set up 
and scheduled through the tape scheduler. The job requesting the ATTACH will be swapped out 
until the file is available. Permanent file utility is running. 

If the CY. parameter is zero or not present and the permanent file has multiple cycles, the default cycle 
attached is the one with the largest cycle number, presumably the latest cataloged. If the CY parameter is 
present and that particular cycle number is not known to the system, the request cannot be honored. If both 
LC and CY are specified, LC is ignored and the conflict is resolved. 

System evaluation of passwords establishes the type of access granted to the user for each file. Subsequent 
to ATTACH, the user cannot access the file in any way for which he does not have permission. For 
example, if ATTACH results in only READ permission, the user cannot subsequently attempt to use 
MODIFY or EXTEND. 

ATTACH does not preclude opening the file. The success of an OPEN request depends upon the permission 
granted when the file is attached. If the file is attached to another control point and multi-read access is not 
possible, PFM will wait for access to the file. 

Attach Example: 

FDBZ FDB . LF, MPILE.MR-1 ,PW-Y, ID-ABC, CY-1 



ATTACH FDBZ.RC.RT 
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The permanent file MFILE is referenced again. Explicitly stating CY=»1 ensures that cycle one will be 
attached. 

In the FDB, only the password for turnkey appears; EXTEND and READ permissions will be granted by 
default. In this example, the macro contains MR = I; therefore ail permissions except READ are ignored, 
making the file available for multi-read access. 

In the macro request, the presence of RC and RT parameters would result in the octal code 25 being 
returned at location FDBZ if the file is unavailable. 



CATALOG 
CLOSE 



FDB1 

LF1, UNLOAD, RECALL 



ATTACH 



FDB1 



FDB1 



FDB 



LF1 , PERMF , TK-T , MD-M , EX-E , CN-C ,PW-T , ID-ABC 



The above example illustrates several points. Assuming that local file LF1 has been created, it is cataloged 
as cycle 1 (by default) of permanent file PERMF. The file is protected by turnkey, control, modify and 
extend passwords. The PW parameter in the FDB is ignored in cataloging. 

After cataloging is complete, a CLOSE/UNLOAD logically detaches the file from the job. 

As illustrated, the file PERMF now can be re-attached. Although not mandatory, the same FDB is used to 
conserve CM space. When PERMF is attached, the default cycle number is the largest cataloged; therefore 
cycle 1 is the only cycle present. The PW parameter contains the turnkey password giving READ access 
permission by default. This example illustrates an implicit read-only attach. 

The same example is shown with two FDBs: 



FDB1 
FDBZ 



FDB 
FDB 



LF1, PERMF, TK-T ,MD-M,EX-E,CN-C, ID-ABC 
LF1, PERMF, PW-T, ID-ABC 



CATALOG 
CLOSE 



FDB1 

LF1 , UNLOAD , RECALL 



ATTACH 



FDB2 
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GETPF FUNCTION (multi-mainframe only) 

GETPF fdbaddr,RC,RT,NR 

The GETPF request requires the lfn, pfn, ID, and ST parameters in the FDB. The optional parameters are the 
same as those for the ATTACH function except for RW, which is ignored if present. See the ATTACH function 
for more detail. 

GETPF prepares for staging the requested permanent file from the mainframe specified by the ST parameter 
and attaching a local copy of that file to the calling routine. The file must be opened before actual staging 
occurs. The mainframe specified by the ST parameter may be either the linked mainframe or the local main- 
frame. In both cases, two files exist after the file is staged: the permanent file and a local copy of the file 
attached to the calling routine. 

The local copy of the file is processed, even if the permanent file specified resides at the same mainframe. 
ALTER FUNCTION 



ALTER 



fdbaddr,RC,RT,NR 



The ALTER function causes the current position of an attached permanent file (designated by lfn in the 
FDB) to be recorded as end-of-information in the RBTC of that file. Permissions needed to perform the 
ALTER function depend upon the context in which function is issued. If the current position of the file is 
less than the file EOI (as attached), modify permission, extend permission and exclusive access are required. 
If the current position is greater than the file EOI, ALTER operates similarly to the EXTEND function and 
extend permission is required. 



RENAME FUNCTION 



RENAME 



fdbaddr,RC,RT 



Any or all information cataloged by the user can be replaced through the RENAME function. The file must 
be attached to the requesting job with all permissions granted. A file owner can change permanent file 
name, cycle numbers, passwords, and even the user ID. 

In the FDB for this request, lfn is the only required parameter. The specified parameters will cause 
replacement of existing parameter information if they contradict the cataloged information. If they dupli- 
cate the cataloged information, the parameters are ignored. 

Parameters which could result in replacement: 



pfn 


Permanent file name 


ID 


Owner identification 


RP 


Retention periof 


CY 


Cycle number 


TK 


Turnkey password 


RD 


Read password 



EX Extend password 

MD Modify password 

CN Control password 

AC Account name 

XR Common password definition 
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The PW parameter may be specified to submit the public password if the file ID is to be renamed PUBLIC. 
Other parameters in the FDB will be ignored. Changing the ID, pfn, or passwords for any cycle cataloged 
will change all cycles. No ID, pfn, or CY changes are permitted if any of the cycles have been dumped 
(mode 2 dump) or archived as retrieval of such files would be impossible. RC and RT are as for 
CATALOG. 

An attempt to rename PFN/ID when the new PFN/ID pair currently exist will be ignored; however, the 
remainder of the specified changes will still occur. 



Rename Example: 



ATTACH FDBA 

RENAME FDBB 



FDBA FDB DFILE, MFILE, PW-Z ,Y,X, ID-ABC 

FDBB FDB DFILE.PFILE2 ,RD-W,MD- .CN-ZZ 

Assuming that MFILE was cataloged with X, Y and Z as passwords for modify, turnkey and control, read 
access would be given by default when DFILE is attached as a local file. By RENAME action, the cataloged 
permanent file name will be replaced with PFILE2. A new password, ZZ, will replace the existing password 
for control permission; a read password, W, will be cataloged for the non-existent read password. The 
password for modify permission will be removed, and none will replace it. The owner's ID remains 
unchanged. Since no cycle number was given in FDBA, the cycle with the largest number will be attached; 
renaming will not change the existing cycle number, as no replacement is given in FDBB. 

FDBl FDB LFILE, MFILE, CY-9.RD-Y, ID-ABC 

FDB2 FDB LFILE, MFILE, CY-8,PW«X,Y,Z, ID-ABC 

FDB3 FDB LFILE, MFILE, RD-Z 



ATTACH FDB2 

RENAME FDBl 



RENAME FDB3 

This example illustrates that for renaming purposes, the same file can be called more than once in a job. If 
the read password was originally cataloged as X, it is changed to Y when the file is renamed as cycle 9, and 
then finally changed to Z. The appearance of an identical ID parameter in FDB 1 will be ignored. 

EXTEND FUNCTION 

EXTEND fdbaddr,RCRT,NR 

Local extensions can be written at the end-of-information point of an attached permanent file, and an 
extend function issued, thus extending the length of the permanent file. The file must be attached with 
EXTEND permission granted. 
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In the FDB, the required parameter is lfn; the extend password, if defined, must appear in the PW list. The 
extended section of the file will acquire the privacy controls of the permanent file. 

If lfn is an indexed file, the current index will be assumed to be the only valid index for the entire file. 
Random files must be closed before an EXTEND request is made. 

Extend Example: 

ATTACH FDBX 



EXTEND FDBX 



FDBX FDB LF1,FR0GLIB1,ID=XYZ 

The program that attaches permanent file PROGLIB1 as the local file LF1 writes beyond the end of 
information. Assuming that no password was required for extend permission, it would be given by default. 
Prior to program termination, the EXTEND request would make permanent any additions written to the 
file. 

PURGE FUNCTION 

PURGE fdbaddr,RC,RT,NR 

A cycle of a file can be removed from the catalog of permanent files by the PURGE function. In the macro, 
fdbaddr is required; RC and RT are as for CATALOG. In the FDB, the lfn is the only required parameter if 
the file was attached before the purge function was issued; all other parameters are ignored. The optional 
parameters are: CY, SN, LC, EC, RB, and PW. Control permission must be granted, or the job will be 
terminated. For the macro request, the FDB referenced may be one used at attach time; or it may be a new 
FDB. Only one cycle of a file may be purged at a time. When the last cycle of the file is purged, the 
entire permanent file name entry is removed from the directory and catalog. 

A user attempting to purge a permanent file already attached must specify the lfn under which the file was 
attached. This purge is by local file name, and the user need provide only the lfn in the FDB. 

To purge a file not already attached, the user must specify a local file name not in use at his control point. 
The permanent file name, ID and password list must be given. If the file resides on a private device set, the 
SN parameter must be given. 

To PURGE a permanent file at a linked mainframe, the user must specify the ST parameter. If both the ST 
and SN parameters are specified, the VSN parameter is ignored and the PURGE takes place at the mainframe 
specified (either the linked mainframe or the local mainframe). If RB=1 is specified in the FDB and the RB 
conflict flag has been set in the PFC by RECOVER, the RBs in the chain will be zeroed and thus the storage 
will not be released to the system. The FNT permissions will be reduced to control only to prevent further 
use of the file. 
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PERM FUNCTION 

The PERM function is available only as a system macro. A running program can determine if a file is a 
non-permanent local file or what permissions have been granted to a currently attached permanent file. 

PERM fdbaddr,RC 

The lfn of an attached permanent file should be given in the FDB. This macro produces a 5-bit code in the 
fdbaddr return code field. The bits represent the following information: 



Bits 0-3 



Bit 4 



1000 CONTROL permission 

1 00 MODIFY permission 

0010 EXTEND permission 

0001 READ permission 



1 non-permanent file 

permanent file 



A return code of zero signifies that the lfn was not in the FNT for the control point (a non-existent file) or 
that some other error was detected. 

Perm Example: 

FDBA FDB DFLN,PFILE,CY=1 .PW-XXX, ID-ABDC 



ATTACH FDBA.RC 



PERM FDBA 

Assuming the file had been cataloged with passwords required for control and modify permissions, the 
ATTACH request would have generated control permission by the password XXX and read and extend 
permissions by default. A subsequent PERM request would cause an octal 13 value to be returned to the 
FDB. The code indicates a permanent file is attached with read, extend and control permissions. 
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PERMANENT FILE UTILITY ROUTINES 

The utility routines provide the capability for dumping permanent files to tape, loading dumped files from 
tape, transferring permanent files and tables from one mass storage device to another, and producing printed 
reports on the status of each permanent file. 

The following routines perform these functions: 

DUMPF Copies all mass storage resident permanent files to tape. The purpose is either to clear all 
permanent files from mass storage devices or to provide periodic back-up files for an installation. May 
be used with system devices or user device sets. 

LOADPF Counterpart of DUMP; required to reload permanent files from tape to mass storage. Loads 
files onto system devices or user device sets. 

TRANSPF Enables permanent files and/or related tables to be transferred to a public RMS device or to 
a private device set. Cannot move system files. 

AUDIT Produces a formatted output file containing statistics on permanent files in the system. User 
device sets and system devices can be audited. 



A permanent file named DUM, having an ID of PUBLIC, must be cataloged before a DUMPF or TRANSPF 
function may be called. Control cards calling these functions must include required passwords for DUM, for 
which an implicit attach will be performed. DUM must reside on the device set on which DUMPF or TRANSPF 
will be working. The DUM passwords are defined by the installation and can be changed as often as desired. 
Since these passwords are used to determine the mode and legality of the utilities, an installation can define 
(and redefine) the passwords to prevent unauthorized users from calling the utilities and thus maintain the 
integrity of the data bases. 

Four passwords are meaningful to DUMPF, turnkey, read, modify, and control. The turnkey password is 
assembled into DUMPF and is specified only for the initial catalog of DUM. The other three passwords are 
specified for the DUMPF utility to determine the mode. If any of the read, modify, turnkey, and control 
passwords are defined, they must be specified on the TRANSPF call. 

The DUMPF routine writes a labeled tape in S format. The job deck must contain a REQUEST card specify- 
ing a file DUMTAPE on a new S tape before the call to DUMPF. A job deck must contain a REQUEST card 
specifying a file DUMTAPE on an existing S tape before a call to LOADPF. Example: 

REQUEST(DUMTAPE,HY,S,N) for DUMPF 

REQUEST(DUMTAPE,HY,S3) for LOADPF 
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DUMPF 

The DUMPF utility is used to clear permanent files from a mass storage device or to maintain selectively a 
file back-up system. Directives may be used to specify the files to be dumped. Files must be dumped to a 
labeled S tape. 

Before DUMPF can be run, a permanent file named DUM with an ID of PUBLIC must be cataloged on the 
device set to be dumped. DUM must have passwords as defined below. These passwords provide the installa- 
tion some security for its files. 

TK*DUMPF Value assembled into DUMPF program 

RD=xxxxx Password used to call DUMPF for mode 1 dump 

MD=yyyyy Password used to call DUMPF for mode 2 dump 

CN^zzzzz Password used to caH DUMPF for mode 3 dump 

Several copies of the DUMPF utility may be executing at the same time. All copies running simultaneously 
must be the same mode and type; the DUMPF parameters must be identical. If an attempt is made to run 
a DUMPF with different parameters than one already mnning, all jobs having issued a DUMPF, except the 
first one, will be aborted. 

DUMPF must be on a system library. Parity errors will be flagged. No files should be attached to a job con- 
taining DUMPF operations during DUMPF execution. 

Before the DUMPF is issued, a REQUEST card must define the dump file, DUMTAPE, as a new S tape. 

The format of the DUMPF control card is: 

DUMPF(pl,p2,...,pn) 

FW is the only required parameter. The parameters listed below may be included. An unrecognizable param- 
eter will cause DUMPF to abort. 



PW«x 

LF=lfn 
MO=n 



Password that allows DUMPF to run. The DUMPF password is defined when the 
file DUM is cataloged. The password specified must correspond with the mode of 
dump desired. 

File to receive output listing. Default is OUTPUT. 

Mode in which DUMPF runs. The value of n may be one of the following: 

1 Permanent files are dumped as backup, leaving the PFC, PFD, and all 
associated disk space intact. The read password must be specified. 
MOl is the default 

2 Permanent files are dumped and associated disk space is released; the 
PFD and PFC entries for the files are left intact. Flags are set in the 
PFD to indicate the file is no longer disk resident. The modify pass- 
word must be specified. This is called an archive dump. 
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Permanent files are dumped and the PFD, PFC, and all associated disk 
space is released as the permanent files are dumped. The control pass- 
word must be specified. Before DUMPF will execute with MO=2 or 
MO=3, the operator must respond to a message: 

THIS WILL BE A DESTRUCTIVE PERMANENT FILE DUMP, 
TYPE GO OR DROP 



CL 

DP=A 
DP=X 
DP=C 

ID=owner 

PF=pfn 

CY=nnn 

IN=ddd 

JN=yyddd 

LA=mmddyy 

DA=yyddd 

CD=mmddyy 

TI=hhmm 



SN=setname 



Complete list option designator. If CL is specified, ail files in the directory are 
listed, whether or not they are dumped. If CL is not specified, only those files 
dumped are listed. 

Dump all files; this is the default. 

Dump expired files. 

Dump files modified, renamed, created, or extended since the last DP=C dump 
was taken. 

Files with this owner identification are dumped. 

Files with this permanent file name are dumped. ID=owner must be specified also. 

Permanent file with specified pfn, ID, and cycle will be dumped. If PF and ID 
are not specified, CY is ignored. If the requested cycle of the permanent file can- 
not be found, a message is issued and DUMPF continues. 

Files inactive this number of days are dumped. See also the TI parameter 
description: 

Files inactive since this ordinal date are dumped. See also the TI parameter 
description. 

Files last attached before this date are dumped. See also the TI parameter 
description. 

Files created, modified, renamed, or extended after this date are dumped. Also 
see the TI parameter description. 

Files created, modified, renamed, or extended after this date are dumped. See 
also the TI parameter description. 

This four-digit time parameter modifies the time associated with CD, DA, JN, LA, 
or In parameters. If none of the latter is specified, TI is ignored. 
Example: LA=031573,TI=1200 files attached since noon on March 15, 1973 will 
not be dumped. Files not attached since noon on March 15, 1973 will be dumped. 

Only files on this device set will be dumped. The master device for this set must 
have been mounted before the DUMPF card is issued. 
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VSN=vsn 



I=lfn 



Only files residing on this device will be dumped. If dumping from a device set, 
the SN parameter also must be specified. If dumping from a system device, VSN 
specifies an EST ordinal and no SN parameter is used. 

Directives will be read from this file. If I is specified, but not equivalenced, 
INPUT is used. If I is not specified, no directive file is used. The directive file 
is used to specify particular files to be dumped. If a directive file is used, the 
only other parameters that can be specified are SN, MO, CL, and PW. The only 
valid parameters for directives are permanent file name (PF*pfn), cycle number 
(CY=nnn), and owner identification (ID=owner). lf directives are used, the date 
and time of the last dump are not modified. Directives can be used only for 
mode 1 dumps. The format of a directive card is: 



PF'=pfn,CY»nnn ) ID* : owner 

The output listing will contain the following items for each cycle: 

Permanent file name 
owner ID 
cycle number 
volume serial number 
date of last dump 
comment 

DUMPF writes the dump to a multi-volume magnetic tape file having the format shown in the following figure: 



Tape Label 



File 
Label 



Volume and Hwttr Libed 



Tap* Mark 



8-word header 

PFO entry (16 words) 

PFC information 



Content! of dumped file 



^E_ 



Dumped 

PerrnerMfit 

File 



Next 

File 



Lest EOR of dumped file 



EOF Tape Mark 



■ w in d Header 
FFO 
MTC 



Permanent File Dump Tape Format 



6-20 



60306500 H 



8-Word Header (format is same as file header label on tape) 



89 


53 




47 




41 


35 




19 


a 


17 




11 


i 





H 









R 


1 




O 


U 


M 




f 


A 




T 


A ■ 




P 




E 


A 







F 


A 




P 


• 




f 


• 




A 




A 


A 




A 


A 


A. 


| 













1 

















1 


A 


A 




A 


A 


1 





1 




A 


1 


B 


1 




ft 


T 


H 


| 


A 


1 M 




E 


V 




E 




a 


X 


























A 




A 




A 


A 




A 


A 


A 




A 


A 




A 


A 




A 




A 


A 




A 


A 


A 




A 


A 




A 


PFD Entry of Dumped Format 

































* 



RBTC Entry up to and Including the First Word of the RBT Chain 



Information in the first 20 characters of tape label: 

HDR I DUMPF TAPE- NEW 
Or: 

VOL 1 DUMPF TAPE- UNIT 



FIELD LENGTH 


FIRST 






(No. of 


CHARACTER 


FIELD 




characters) 


POSITION 


DESCRIPTION 


NAME OF FIELD 


3 


I 


HDR 


Label identifier 


1 


4 


1 


Label numer 


17 


5 


DUMP TAPE OF P.F. 


File label name 


6 


22 


(blank) 


Multifile identification 


4 


28 


0001 


Reel number 


4 


32 


0001 


Multifile position number 


4 


36 


(blank) 


Reserved for tape compatibility 


2 


40 


01 


Edition number 


1 


42 


(blank) 


Reserved for tape compatibility 


5 


43 


BIRTH 


Creation date 


I 


48 


(blank) 


Reserved for tape compatibility 


5 


49 


NEVER 


Expiration Date 


1 


54 


X 


Security 


6 


55 


000000 


Block count 


20 


61 


(blank) 


Reserved for tape compatibility 
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DUMPF EXAMPLES: 

I. JOB. 

REQUEST(DUM.*PF) 
COPYBR(INPUT.DUM) 

CATALOG(DUM,OUM,TK-OUMPF.RD-PERM1.MD-PERM2,CN-PERM3.f»W-public password) 
7/8/9 



7/8/9 
6/7/8/9 

This job catalogs DUM on the system set prior to running DUMPF. 

2. Full dump of all permanent files, assuming DUM was cataloged as in example 1. Files on user device 
sets will not be dumped. 

JOB. 

REOU£ST(DUMTAPE.HY.S,N» 
DUMPF (PW-PERM1) 
6/7/8/9 

3. Dump cycle 3 of permanent file TESTFILE with ID of SAM, releasing disk space and the PFD and 
PFC entries for this cycle. 

JOB. 

REQUEST(OUMTAPE,HY.S.N) 

DUMPF(PW«PERM3.PF-TESTFICE.CY-3.MO«3.IO-SAM» 

6/7/8/9 

4. Dump all files cataloged under the ID of MARLOWE, releasing disk space but keeping directories intact. 
JOB. 

REQUESTJDUMTAPE,HY,S,M) 

DUMPF(PW-PERM2,»D-MARLOWEMO-2> 

6/7/8/9 

Dump certain files of device set SPECPRJ whose master device has volume serial number 479. 

JOB. 

MOUNTtSN-SPECPRJ.VSN-479) Mount mast* 

REQUEST OUM.'PF.SN-SPECPRJ. 

REWINO DUM. 

CATALOG DUM,TK-OUMPF.RD«PERM1. 

MD-PZ.CN-P3.PW-public password. 

RETURN(DUM) 

REQUESTIOUMTAPE.HY,S,N) 

DUMPF(I,PW»PERM1,SN-SPECPRJ) 

7/8/9 

PF=COBOL.CY-39,ID-RON 

PF-FTN.IO-SLEITER 

PF =RUN .CY-79.1 D-CDCSV L 

6/7/8/9 
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LOADPF 

The LOADPF utility loads permanent files that have been dumped to tape. All (or a selected portion of) files 
on the tape may be loaded. An optional directive file specifies individual files to be loaded. Multiple copies 
of LOADPF may execute at the same time. A job may access a file as soon as it is entered into the permanent 
file tables. For each cycle loaded, LOADPF makes an output listing entry that contains the permanent file 
name, owner ID, cycle number, date of last dump, and a comment. 

If the dump tape contains a duplicate permanent file name, owner ID combination for a file to be loaded, 
a message is sent to the operator and the file is ignored unless LP=R is specified. If a parity error occurs 
during loading, the file is flagged in the permanent file tables. LOADPF aborts if it encounters an 
unrecognizable parameter in the program call statement. 

Before LOADPF is called, a REQUEST or LABEL control card must define a load file with the name 
DUMTAPE, residing on an existing labeled S tape. 

The format of the LOADPF control card is the following: 

LOADPF(pl,p2, . . . ,pn) 

All parameters are optional. Permissible parameters are: 

LP=A Load all files; this is the default. Existing files are not replaced unless the file is 

incomplete or not disk resident. 

LP=P Load files only if present in the permanent file directory and not disk resident • 

(archived). 

LP^X Do not load expired files. 

LP=R Replace existing files. Both X and R may be specified in the form LP=X,R. 

LP=0 Permanent file dump tape is in SCOPE 3.2 or 33 format. If LPO is not specified, 

the tape is assumed to be a SCOPE 3.4 permanent file dump tape. The O option 
may be used with other LP parameters in the form LP=R,0,X. 

LF=lfn Use logical file name Ifn as output file. The default is the file OUTPUT. The out- 

put listing will be written to this file. 

CL Complete list designator. If this parameter is specified, all files on the dump tape will 

be listed, whether or not they are loaded. If CL is omitted, only loaded files will 
be listed. 

SN=setname Specifies the name of the device set to which the files are loaded. The master device 

of this set must have been previously mounted. 

VSN=vsn If loading a device set, specifies the volume serial number of the RMS device onto 

which the permanent files are loaded. The SN parameter must also be included, and 
the master device of the set must have been previously mounted. 

VSN=eq If loading a system device, specifies the EST ordinal of the RMS device onto which 

the permanent files are loaded. 
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ID=owner All files with this owner ID will be loaded. 

PF=pfn All files with this permanent file name and the specified owner ID will be loaded. 

ID=name must also be supplied. 

CY=nnn The cycle of the specified permanent file name/owner ID is loaded. ID=owner and 

PF=pfn must also be given. Unless a specific cycle number is given, all cycles of the 
file will be loaded. 

I=lfn Read directives from a file with this logical file name. If I is not specified, no 

directives are used. If I is specified but not equivalenced, directives are read from 
the file INPUT. The permanent file name (PF), cycle number (CY), and owner 
identification (ID) may be specified. If a directive file is used, only those files speci- 
fied are loaded. The format of the directives is the following: 

PF=pfn,CY=nnn,ID=owner 

If a directive file is used, the only other parameters that can be specified are CL 
and SN. 



ARCHIVE FEATURE 

The archive feature is automatic, and the user will be unaware of this system activity when loading is from 
tape. When an attempt is made to attach an archived permanent file, the operator may type n.GO which 
causes the file to be loaded from the appropriate dump tape. An archived file can be purged without actually 
loading the file. 



LOADPF EXAMPLES 

JOB1. 

REQUESTS DUMTAPE.HY,S,E) 

LOADPF. 

6/7/8/9 

This job loads all files on the tape unless LOADPF finds the owner ID, permanent file name, and cycle num- 
ber combination already in the system; such files are skipped. 
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J082. 

REQUEST(DUMTAPE.HY,S,E) 

LOADPF<LP-X> 

6/7/8/9 

This job loads all non-expired permanent files from tape. 

JOB3. 

REQUEST{DUMTAPE.HY,S.E) 
L.OADPF<PF-STARTR£K,ID»5POCIO 
6/7/8/9 

All cycles of the permanent file STARTREK with owner ID SPOCK are loaded unless one of the following 
conditions arises: 

The permanent file name/owner ID combination already exists in the system with different passwords. 

A duplicate cycle number is encountered. 

The permanent file name/owner ID combination already has five cycles cataloged. 

JOB4. 

REQUESTIDUMTAPE ) 

UOADPF(I) 

7/8/9 

PF«PASSERIFORMES,CY=21 ,l D=VEERY 

PF-ANATINAE.ID-GADWALL 

PF«PRQC£LLARHFORMES,I0=FUL.MAR 

6/7/8/9 

This job loads the specified permanent files from tape. 

TRANSPF 

The TRANSPF utility can do either of the following: 

Change the residence of files and permanent file tables within a device set so that all permanent file 
information may be removed from a device, (single device set TRANSPF) 

Copy files from one device set to another, (dual device set TRANSPF) 

The format of the control card is the following: 

TRANSPF(pl,p2, . . . ,pn) 

The TS parameter is always required. The PW parameter is required if passwords have been defined for the 
file DUM. The format of the parameters is the following: 

PW=a,b,c Specifies read, control, turnkey, and modify passwords if they are defined for the perma- 

nent file DUM. If passwords have been defined for the file DUM, they must be specified 
with this parameter or the utility will abort. No default exists. 
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FS=setl Name of the device set from which the permanent file information is to be transferred. 

TS=set2 Name of the device set to which the permanent file information is to be transferred. 

FM=vsnl Volume serial number (VSN) of the member device from which the permanent file infor- 
mation is to be transferred. Required when setl=set2. Cannot be specified when setl : > t set2. 
Assumed value when setl#set2 is all devices in setl. 

TM=vsn2 Volume serial number (VSN) of the member device to which the permanent file information 
is to be transferred. Data that cannot be contained on this device will overflow to another 
member of the device set specified by TS. Cannot be specified when set¥set2. If setl=set2, 
files will not overflow into the FM device. Default is all devices in set2. If setl=set2 and 
FM specifies a master device, TM is required. 

LF=lfn Name of the file on which the output listing is written. Default is OUTPUT. 

Before the TRANSPF utility can be executed, a permanent file with the name of DUM and ID of PUBLIC 
must be cataloged on the device set specified by the FS parameter. If this is not done, TRANSPF will abort. 

TRANSPF will issue an internal ATTACH of the permanent file DUM; the passwords submitted in this ATTACH 
will be those that are submitted via the PW parameter on the TRANSPF request. If TRANSPF is unable to 
attach the permanent file DUM, the function will abort. 

To prevent overflow on PF assignment, the FM device is changed to a non-PF device prior to data transfer. 

Before the TRANSPF utility is called, a MOUNT must be issued for the master devices of the device sets 
specified by the FS and TS parameters. TRANSPF must have exclusive access to the set; if the set is 
mounted on shared drives, no other MF can be logged in (have set mounted). 

SINGLE DEVICE SET TRANSPF (set1=set2) 

A single device set TRANSPF is requested if the device set specified by the FS parameter is the same as the 
device set specified by the TS parameter. 

TRANSFERRING FROM A MEMBER 

If the FM parameter does not specify a master device, permanent files residing on the FM device will be moved 
to the TM device. A file will be moved if any part resides on the FM device. Once the file has been transferred, 
the disk space associated with the old copy will be released. If the file cannot be completely contained on the 
TM device, the file will overflow to another device in the set, but will not overflow onto the FM device. If the 
transfer of a file is unsuccessful, that file will be skipped, but TRANSPF will not abort. A file transfer may be 
unsuccessful because of: 

uncorrectable parity errors; 

not enough space in the device set to accommodate two copies of the file simultaneously; 

permanent file catalog full. 

When all permanent file information is successfully transferred from the FM device, that device will be desig- 
nated as a non-pf device. 
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TRANSFERRING FROM A MASTER 

When the FM parameter specifies a master device, the device set tables will be moved to the device specified 
by TM, and the device labels for both devices will be updated to reflect the new organization of the device 
set. If the tables cannot be successfully moved, the device set will not be changed by the TRANSPF utility. 
Table transfers may fail for one of the following reasons: 

uncorrectable parity errors; 

not enough space on the TM device to completely contain the disk tables. 

After the master device is successfully changed, permanent files residing on the FM device will be moved to the 
TM device as described above. When all permanent file information is transferred from the FM device, that 
device will be designated as a non-PF device. 

Examples 

FIRST. 

MOUNTCSN-TEST.VSN-999) Mount mntar 
TRANSPF (FS-TEST,TS-TEST.FM«999/TM-t 1 1 J»W-A) 
6/7/8/9 

This job transfers all permanent files and permanent file tables from the master device with VSN of 999 to 
the member device with VSN of 111. Both devices belong to device set TEST. Note that the member device 
with VSN 111 was not explicitly mounted. The system initiates the mount of the member when actual I/O 
is requested by TRANSPF. If this job runs successfully, device 111 will be the master device of set TEST. 

If the tables do not fit on the device with VSN 111, the set will not be changed, and the job will end. If 
the tables are successfully transferred, but the permanent files do not fit on the device with VSN 111, the 
files will overflow to any devices in the set TEST except the device with VSN 999. 

The permanent file DUM is assumed to have been previously cataloged with password A on device set TEST. 

SECOND. 

MOUNT<SN-T£ST1.VSN-655) Mount matter 

TR ANSPF{FS-TEST1 TS-TE5T1 .FM-888.TM-222.Pwa) 

677/879 

This job transfers all permanent files from the member device with VSN 888 to the member device with 
VSN 222. Both members belong to the device set TEST1. Note that the members with VSNs of 888 and 
222 were not explicitly mounted. The system initiates the mount of these members when actual I/O is 
requested by TRANSPF. 
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DUAL DEVICE SET TRANSPF <Mt1#Mt2) 

A dual device set TRANSPF is requested if the device set specified by the FS parameter is different from the 
device set specified by the TS parameter. 

TRANSPF transfers permanent files by simulating the following sequence of control cards: 

REQUEST(tfn2.SN-wt2l 
ATTACHUf n! .pf n JO-own«r,SN°s«t1 1 
COPY(Hn1,lfn2» 
CATALOG<lfn2,p»n,ID-own«r) 
RETURN<lfn1,lfn2) 

All files residing on the device set specified by the FS parameter are transferred to the device set specified by 
the TS parameter. The FM and TM parameters cannot be used; no member devices can be specified. 

A permanent file transfer will be unsuccessful if one of the following conditions exists: 

filel has an uncorrectable parity error; 

CATALOG is unsuccessful, e.g. PFD or PFC full in TS set; 

not enough disk space is available on the TS device set to contain filel. 

After a successful transfer of a file, two copies of the file exist, one in the FS device set and one in the TS 
device set. 

Note that in a dual device set TRANSPF the disk tables are not moved as a separate entity; critical tables 
are only moved within a device set and never from one device set to another. 



Example 

JOB. 

M0UNT(SN-BOB.VSN-1944) Mount master 

MOUNT(SN-TOM,VSN-1984) Mount matter 

TRANSPF<FS-BOB,TS-TOM.PW-YES) 

6/7/8/9 



This job moves permanent files from the device set BOB to the device set TOM. 
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AUDITING PERMANENT FILES 

With the AUDIT utility, the user can obtain the status of permanent files. The user can restrict the AUDIT 
to a specific user ID, permanent file name, or device set. The AUDIT utility provides printed reports con- 
taining basic accounting information. AUDIT runs in two modes. Full mode produces a printed report con- 
taining all the information listed below. A partial audit produces only the items marked with *. 



•Setname 

•Permanent file name 
♦Owner ID 
""Cycle number 
•Creation date 
•Expiration date 
•Date of last attach 
•Date of last alteration 



•Account name 
•Size in number of PRUs 
•Public device EST ordinal 
Number of attaches 
Number of extends 
Number of rewrites/alters 
File size (number of RBs) 
Subdirectory 
RB conflict flag 



Archive flag (VSN printed) 
Time of last attach 
Time of last alteration 
VSNs of files dumped 
Loading parity error flag 
Positioning flag 
Random flag 
SAAM flag 
New version flag 



The format of the AUDIT control card is: 

AUDIT(keyword=value, . . . ) 
All parameters are optional. The following parameters may be used with AUDIT: 

LF=lfn Logical file name to receive the output listing created by AUDIT. Default is OUTPUT. 



MO=m 



ID=name 

PF=pfn 

AI=F 
AI=P 

SN=setname 

VSN=vsn 
AC=n 



The mode of the AUDIT. Only one mode may be specified. The value of m may be 
one of the following: 

A AUDIT all files; this is the default value. 

X AUDIT expired files. 

D AUDIT inactive cycles. 

I AUDIT incomplete files. 

P AUDIT files with parity errors. 

R AUDIT archived files. 

Owner identification; AUDIT all files with a particular owner identification. 

Permanent file name; AUDIT all files with this pfn. If this parameter is used, the 
ID=name parameter must also be used. 

Produces a full two-line output for each file audited. This is the default. 

Produces a partial, one-line output for each file audited. 

Device set to be audited. The master device for this set must have been previously 
mounted. 

Volume serial number of device to be audited. All files residing on the device will be 
audited. The master device for this set must have been previously mounted. The 
SN=setname parameter must also be specified. 

Account number; AUDIT all files with this l-to-9-character account number. 
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All 
Files 


Archived 
Files 


Expired 
Files 


Files of 
Same ID 


Files on a 
Certain Unit 


Partial 
Audit 


Full Audit 
or Account 


Owner ID 


X 


X 


X 


X 


X 


X 


X 


Permanent File Name 


X 


X 


X 


X 


X 


X 


X 


Cycle Number 


X 


X 


X 


X 


X 


X 


X 


EST ORDINAL 

(If On a Public Device) 


X 




X 


X 




X 


X 


Creation Date 
(ordinal) 


X 


X 


X 


X 


X 


X 


X 


Expiration Date 
(ordinal) 


X 


X 


X 


X 


X 


X 


X 


Date of Last Attach 
(ordinal) 


X 


X 


X 


X 


X 


X 


X 


Date of Last Alteration 
(ordinal) 


X 


X 


X 


X 


X 


X 


X 


Account Parameter 


X 


X 


X 


X 


X 


X 


X 


Number of Attaches 


X 


X 


X 


X 


X 




X 


Number of Extends 


X 


X 


X 


X 


X 




X 


Number of 
Rewrites/ Alters 


X 


X 


X 


X 


X 




X 


VSN of dump 
tapes (first/last) 


X 


X 


X 


X 


X 




X 


Length (No. PRUs 
determined by Inst. Par.) 


X 




X 


X 


X 


X 


X 


Flagst 


X 


X 


X 


X 


X 




X 


Subdirectory Number 


X 


X 


X 


X 


X 




X 


Length in RBs 


X 




X 


X 


X 




X 


Time of Last Attach 


X 


X 


X 


X 


X 




X 


Time of Last 
Alteration 


X 


X 


X 


X 


X 




X 



t Flags set will be represented by the following letters produced on AUDIT output: 



R Random file 
S SAAM file 
A Archived file 



N New version file 

E Parity error in file 

P Positioned 

C RB conflict 



Figure 6-2. Table of AUDIT Outputs 
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I Permanent File Utility Function Codes (octal) for system interface between PF Utilities and PFM routines: 



AUDIT 


166 


DUMPF 


172 


LOADPF 


174 


TRANSPF 


176 



Permanent File Utility Keyword Codes (octal): 
Keyword Code 



TR 
MO 

UN 
DA 
DP 

IN 
El 

E2 

LP 

J.N 

TI 

AI 

LF 

ID 

PF 

PW 
CY 



57 
60 
61 
62 
63 
64 
66 

67 

70-73 

74 

75 
76 
77 
14 
30 

20-24 
03 



Description 

(...) indicates format of values in FDB 

Dump tape type 7 or 9 track (binary) 

Load or audit dump mode (display code) 

Dump, load or audit unit EST ordinal (binary) 

Date parameter for file dumps (display code) 

Dump mode parameter (display code) 

Inactive file dump parameter (binary) 

Transfer files tables from unit EST ordinal 

(binary) 

Transfer files tables to unit EST ordinal (binary) 

Load type parameter (display code) 

Date parameter for file dumps (display code) 

Time parameter for file dumps (display code) 

Audit type parameter (display code) 

Audit output file parameter (display code) 

Load by file ID name parameter (display code) 

Load by ID and pfn names parameters (display 

code) 

Passwords to attach file DUM (display code) 

Load by ID, pfn and cycle parameters 
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PERMANENT FILES/SYSTEM INTERFACE 

Two pointer words in the CMR pointer area contain pertinent system information about files. Word 6 contains 
the number of attached permanent file table entries, the starting address of the attached permanent file table, 
and a byte of flags. Word 7 contains the MST ordinal of the system set and PF default set; the starting 
address and number of entries in the dismountable device table, and the starting address and number of entries 
in the mounted set table. 

PERMANENT FILE INTERLOCKS 

Several types of interlocks are used to prevent conflicts during the accessing of permanent files on RMS devices: 

Hardware interlocks 

Set interlocks in the label 

Set interlocks in the Mounted Set Table (MST) 

Interlocks in the Set Member Table (SMT) 

Permanent File Manager (PFM) interlocks in the MST 

Utility interlocks in the MST 

Attached Permanent File (APF) interlocks 

Hardware interlocks are used by RECOVER, TRANSPF, SPM, and PFM to test and set interlocks residing on 
a device, and to prevent any changes to critical tables (SMT, DAM, PFC, and PFD) on the master device if 
the set is already mounted on any mainframe. They can be set using an interlocked stack request and released 
by making a stack request without interlocks. They are retained when interlocked stack requests continue 
from the same PP or to the same FNT as with the first stack request. 

Set interlocks in the label are used to prevent set routines (such as ADDSET) on other mainframes from 
simultaneously updating critical tables (SMT, DAM). When this interlock is set, no other mainframe is 
allowed to run a MOUNT on the master device until the interlock is cleared. Thus, a program can ensure 
that no other mainframe will access a particular set by first checking that no other mainframe has yet 
mounted the master device and then setting the set interlock in the label. To set this interlock, first the 
label should be read with hardware interlock, then the interlock should be tested and set, and finally the 
label should be rewritten without hardware interlock. To release this interlock, first the label should be read, 
then the interlock should be tested and cleared if still set, and finally the label should be rewritten. 

Set interlocks in the MST are used to prevent two or more set routines from running on the same mainframe. 
(Note that this function can also be performed by the set interlock in the label.) The purpose of keeping 
the central memory set interlock is to allow jobs to swap out while waiting for the set interlock in central 
memory to clear; thus, the action if the interlock in central memory is not set is different from the action 
required if the interlock on the device is not set. The set interlocks in the MST can be set by reserving 
the MST channel, setting the interlock, and then releasing the MST channel. The interlocks can be cleared by 
reading the MST entry, testing and clearing the interlock if not already cleared. 

Interlocks in the SMT are used to interlock member devices, preventing other mainframes from mounting the 
device so that it can eventually by physically dismounted. They are also used by RELABEL to ensure 
exclusive access to the device's SMT, DAM, etc. There are five such interlock bits in the SMT: four 
correspond to the mounted/unmounted flag on the four possible mainframes; the fifth is a request dismounted 
flag. This last flag, when set, prevents any other mainframe from mounting the device; thus, it can be used 
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to interlock a member which is not yet mounted. These bits can be set by reading the SMT with hardware 
interlock, setting the request dismounted flag, and then rewriting the SMT releasing the hardware interlock. 
They can be released by reading the SMT with hardware interlock (necessary because the SMT interlock only 
interlocks the SMT entry, not the entire PRU containing the entry), testing and clearing the interlock if not 
already cleared, and then rewriting the interlock. 

PFM interlocks in the MST are used to prevent two or more PFM routines from simultaneously accessing the 
PFD or PFC within a single mainframe. This can also be achieved with interlocked stack requests; however, 
the central memory interlock may allow jobs to enter the event stack to wait for the PFM interlock in the 
MST to clear. Furthermore, it also prohibits TRANSPF's table transfer mode from running in the same 
mainframe at the same time. 

In a multi-mainframe environment, the permanent file disk tables PFD and PFC are accessed with interlocked 
stack requests so as to provide interlocking between mainframes; however, within a single mainframe, the 
same PFM interlock is used to interlock both the PFD and also the PFC. The PFM interlock is set based on 
the device set (that is, in the MST) and is always cleared along with the device interlock whenever the PP 
takes an abnormal exit. When a broken connect occurs during the process of reading or writing the PFD or 
PFC, new sequences are executed to perform extensive checking and clean-ups for recovery attempts. 

For a complete permanent file cycle, the type of access permission currently granted to each mainframe is 
recorded in the PFC interlock word in the PFC entry. To access an individual permanent file, it must be 
ensured that there are no access permission conflicts with the other mainframes. For an incomplete 
permanent file cycle, only exclusive access permission is granted to one mainframe by recording its main- 
frame ordinal in the PFD entry. 

The PFM interlocks in the MST can be set by reserving the MST channel, setting the interlock, and then 
releasing the MST channel. They can be released by reserving the MST channel, reading the MST entry, 
testing and clearing the interlock if still set or else allowing error exit for the interlock if not still set, and 
finally releasing the MST channel. 

The utility interlock bit in the MST is used to TRANSPF in conjunction with the set interlock bit in the 
master device label after testing that no other mainframe has the set logged-in and that the permanent file 
manager activity is quiet on the set. This will both assure the host mainframe exclusive access to the set 
while transferring disk tables and also prevents CATALOG and ATTACH functions on the same mainframe. 
This bit is set by reserving the MST channel, setting the interlock bit, and then releasing the MST channel. 
The interlock is cleared by reserving the MST channel, clearing the interlock if set or allowing error exit for 
the interlock if not set, and finally releasing the MST channel. 

The APF interlock (CH.APF) is used for interlocking the APF table, preventing two or more routines from 
simultaneously accessing or updating the table. With the single PFM interlock, an empty APF slot is 
reserved before the PFD search in the PFA, PFC, and LPF; furthermore, the PFD, APF, and PFC processing 
are all performed under the same PFM interlock. The APF interlock is set by reserving the APF channel, 
setting the APF flag in the APF entry, and then releasing the APF channel; it is cleared by clearing the flag 
in the APF entry. 
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PERMANENT FILE TABLES 

There are four system files created as permanent files during system deadstart; the system dayfile, the CE 
error file, the edit-extension file, and the system (library) file. Each has an entry in the Permanent File Direc- 
tory (PFD) and the Permanent File Catalog (PFC). The PFC was formerly called the RBT catalog (RBTC). 
These names may be used interchangeably. 

PFD and PFC are of fixed length, and reside on the same mass storage device. A user device set has its own 
PFD and PFC on the master device of the set. Pointers to these tables are kept in the device label. 

The APF Table is CM resident and consists of two word entries, up to a predefined size for the installation 
(L.APF, default of 30 decimal). 

The PFD has a header at the beginning of subdirectory 1, followed by a number of subdirectories of equal 
length. The PFD header is a copy of the PFD's RBT chain for use in recovery. Each subdirectory consists of 
PFD entries. 

The PFD is a file whose first allocation unit is recorded in the device label of a master device. This file has 
two fixed length parts. The first part, called the preamble, is always 512 words long. It contains a complete 
list of record blocks assigned to the PFD. The second part, called the PFD body, contains the individual entries. 
The size of the PFD body must always be an integral multiple of pages. Also, this multiple must be a power 
of 2. The size of the PFD body must be less than 511 pages. The PFD body is initialized to binary zeros. 

The size of a PFD entry is always 16 words, four per PRU. 

The PFD body will have n ID hash points. These hash points will be equally spaced within the body and the 
space between any two ID hash points will be an integral multiple of pages and this multiple will be a power 
of two. The number (1 to n) of the hash point is the ID hash. 

Since space between two ID hash points is a multiple of pages, the start of each of these pages will be a 
PFN hash point. 

A sub-directory is a subset of PFD entries which have a common ID hash. 

Up to five cycles or versions of each permanent file can be maintained. The PFD entry, therefore, can have 
up to five pointers to the PFC, each corresponding to an entry for a cycle. Each cycle entry contains the 
cycle number, the mainframe ordinal (for incomplete cycles only), four flags, and the PFC pointer. The 
mainframe ordinal indicates the mainframe currently accessing the cycle, so that in a multi-mainframe environ- 
ment exclusive access can be granted. The first flag signifies that this cycle has been dumped and is unavail- 
able (retained for 3.3 files by CONVPF only); the second, that the entry is incomplete since no PFC pointer 
exists; the third, that the cycle is archived; and the fourth, that the cycle has a parity error. 

When cataloging, the user may specify the number for the cycle or permit a cycle number to be generated 
automatically. Unless the user specifies the cycle when attaching a file, he will get the one with the highest 
cycle number. Cycle numbers range from 1 to 999. 

The permanent file name (pfn) can consist of up to 40 characters. The PFD entry also contains the passwords 
given when the file was cataloged. PFD entries are placed into appropriate subdirectories by a hashing algo- 
rithm applied to the file's ID. 
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The entry-in-use flag in word zero of the PFD is set when an entry is built. Detailed formats of the PFC and 
PFC entry appear in part II, section 3. 

Detailed formats of other tables relating to device sets are included in part II of this manual. The Set Mem- 
ber Table (SMT) is a directory of the members of a device set. The Device Allocation Map (DAM) functions 
like an RBR for a device. The DAM is copied to central memory when the device is mounted, maintained in 
central memory wljile the device is being used, and copied back to disk when the device is dismounted. The 
subdirectory table is used to keep track of the number of permanent files in each subdirectory. The flaw 
table and physical flaw tables reserve space on a device for areas with hardware flaws. PFC entries are always 
allocated in blocks of 64 words. One PFC entry may occupy several blocks which must be contiguous. 

Figure 6-7 is the format of the APF entry. Whenever a permanent file is attached to a control point, an 
entry is made for it in the APF table. A pointer in the first word of an FNT entry or cataloged for a 
permanent file relates that entry to the corresponding APF entry. The APF table is an interlock list which 
allows multi-read access without reloading the RBT chains and also controls queuing for exclusive use of the 
file. An empty APF entry can be reserved by setting the APF reserved flag in bit of word 2. 



59 



47 



35 



23 



17 



C.PFD1 


C.PFD2 


C.PFD3 


C.PFD4 


C.PFQ 
PFQ Address 


■^ 


" r 1 U 1 omit 






C.PFRBT 
First RBTA 


C.PFCNT2 
Count 2 


C.PFCNT 
Count 1 


C.PFCY 
Cycle No. 


C.PFLAG 
Flag Byte 






C.PFLAG 









Word 1 



Word 2 



11 10 9876543210 



Archived Pf 

from 

6000 to 7000 

(Reserved) 

System PF 

Obsolete FRBT 

Archive 

File attached 

on another 

mainframe 



^ 



£ 



Figure 6-7. APF Table Entry 



Entry reserved 
Single write 
Single modify 
Exclusive access 
RB conflict 
Interlock 



INCOMPLETE CYCLE 

An incomplete cycle is a file that has a PFD entry but no RBTC entry. It can result from either a CATA- 
LOG or LOADPF job that does not terminate normally. An incomplete cycle can be attached and purged 
if the CY parameter is used to specify the cycle and control permission is established. 
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The PFC, like the PFD, is a file whose first allocation unit is recorded in the device label of a master device. 
This file has two fixed length parts. The first part, called the preamble, is always 512 words long. It contains 
a complete list of allocation units assigned to the PFC. The second part, called the PFC body, must always 
be an integral multiple of pages. This multiple need not be a power of two. The PFC body is initialized to 
binary zeros. 

PFC entries are always allocated in blocks of 64 words. One PFC entry may occupy several blocks which 
must be contiguous. 

PERMANENT FILE ACCOUNTING 

When W.CPFACT in the control point area is non-zero, accounting messages will be sent to both the system 
and user dayfiles whenever the status of a permanent file changes in the job. These messages are given in the 
SCOPE 3.4 Reference Manual. The ACCOUNT card will set W.CPFACT non-zero. 

PRIVATE DEVICE SET PROCESSING 

A device set is a group of one or more rotating mass storage devices. Files may be written to device sets and 
made permanent. Device sets may be used simultaneously by many jobs. A file will not be written on a 
private device set unless specifically directed to the set. 

The control cards described in this section are for creating, maintaining, and using device sets. With the ex- 
ception of REQUEST, these functions are not available through macros. Private device sets are supported only 
on removable devices such as CDC 841, .854, and 844 disk packs. 

DEVICE SET CREATION AND MAINTENANCE 

The first step in establishing a private device set is to blank-label the packs using LABELMS. LABELMS must 
be run in any case, even if DELSET has been run on the device. 

The next step is to use the ADDSET control card to establish a master device for the set. The master device 
contains ail the device set related tables. 

Once a master device has been established, the device set exists. Packs can then be added to the set with 
ADDSET or deleted with DELSET. The RECOVER function can be used to verify the device set tables. 

The LABELMS and ADDSET control cards may not be entered through INTERCOM. 

DEVICE SET LABELING (LABELMS) 

The LABELMS utility is used to blank-label a rotating mass storage device. When LABELMS is executed 
(except during deadstart), the system requests the equipment status table (EST) ordinal and volume serial 
number (VSN); these must be assigned by the operator. If a device type (DT) is not specified in the state- 
ment parameter list, the operator may specify the device to be blank-labeled. LABELMS can also be used to 
inhibit preallocation of space for C.E. diagnostics, specify allocation information for subsequent access to the 
device, and record known flaws on a device so that such areas are not accessed. The deadstart routine GENDJ 
uses the LABELMS utility during an initial deadstart to blank label RMS devices and to determine flaws from 
factory format information. 
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The statement format is: 

LABELMS(DT=ttJNPIM)S,EST«est4=lfn) 
Parameters are optional 

DT=tt Device to be labeled; device codes for tt are: 



AA 


6603*1 Disk 


AB 


6638 Disk 


AC 


66030 Disk 


AL 


821 Disk 


AM 


841 Disk Pack 


AP 


854 Disk Pack 


AY 


844 Disk Pack 



NPR No space is to be preaflocated for C. E. diagnostics. If NPR is not specified, space will be 

allocated at the following cylinder numbers (in octal): 



Device 



Cylinder 



6638 


37 


6603 


177 


821 


777 


841 


311 


854 


311 


844 


632 



DS Deadstart parameter, not available to users, used only by the operating system to call 

LABELMS during post-deadstart. 

EST=est EST ordinal used only when DS is specified; not available to users. 

I=lfn Logical file name for input directives containing allocation and flaw information. If I is 

specified but not equivalenced to a file, the default file name is INPUT. If I is omitted 
entirely, no directives are expected, default allocation information is used and the disk is 
presumed to be free of flaws. DT must be specified if I is specified. 

The directives have the following format: 



Allocation directives: 



Flaw directives: 



Aas,Rpru,Nrbs. 

Ppn,Hhn,Ssn. \ 
Ppn,Hhn,Sfsn-lsn. f 
\ Ttn,Ccn,Ssn. \ 
[ Ttn,Ccn,Sfsn-lsn. f 



f 



Devices 6638 and 6603 
Devices 841, 821, 854, and 844 
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Use one allocation directive for each DAM (RBR) desired on the device. 

as Allocation style. The limits of as are to 77 octal; default is as=0. The allocation style 

enables the user to request a specific allocation feature, such as directing a file to a specific 
portion of a device which may have a particular record block size and/or recording technique. 

pru Number of PRUs per record block. The limits of pru are 2 to 7777 octal, except that for 

every device, pru must be greater than or equal to 1/32 of the RB and less than or equal to 
32 times the RB. Default depends on the device; see the table below. If the default value 
for pru is not desired, the value specified should be either an integral multiple or an integral 
factor of the default value for the device. 

rbs Number of record blocks in the RBR (record block reservation table) for this device or 

portion of device. The RBR, maintained by SCOPE in central memory, contains information 
indicating its associated allocation style and the status (available or not available for assign- 
ment) of all record blocks governed by this RBR. The limits of rbs are 1 to 7777 (octal). 
Default depends on the device; see the table below. 



pn 


Position number. 


hn 


Head group number. 


tn 


Track number. 


en 


Cylinder number. 


sn 


Sector number. 


fsn 


First sector number. 


Isn 


Last sector number. 



limits depend on device; see the table below. 



Indicate several contiguous flawed sectors. 



NOTE 

User packs may have one RBR per pack, with R > standard and 
N < standard, and all packs in a set must be the same. 

For both user and public packs: No more DAMs may be created 
than are configured in CMR for the drive; and total RBs for the 
device must not exceed the total size of the RBRs configured in 
CMR. 
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DEVICE RELABELING 

RELABEL is used by deadstart to rewrite the label on RMS devices in order to add or delete flaws or to 
recreate a label that has been destroyed. The format of the RELABEL control card is: 

RELABEL(VSN=vsn,SN=setname,MP=mpJ s =0,0=OJ)S) 

vsn Volume serial number of device to be relabeled. 

sethame Name of the device set containing the device. 

mp Volume serial number of the master device of the device set. 

1=0 Specifies no input file. 

0=0 Specified no output file. 

DS Specifies that RELABEL is being run under deadstart. 

RELABEL run under deadstart obtains a complete new set of flaws from IRCP through CMR, rewrites the 
PFT and the device label, and rewrites the DAM and LFT for the device on the master device. It detects 
any conflicts between the new flaws and already existing flies and system tables, and advises the operator 
when such conflicts exist. 



Device 


pru Default 


rbs Default 


pn, tn limits 


hn, en limits 


sn limits 


6638 


62 


4000 


to 37 


to 37 


to 143 


6603-1 


62 


2000 


outer 0-3 
inner 4-7 


to 177 


to 177 
to 143 


6603-11 


100 


2000 


outer 0-3 
inner 4-7 


to 177 


to 177 
to 143 


841 


70 


1750 


to 23 


to 307 


to 15 


821 


466 


4000 


to 77 


to 777 


to 23 


854 


4 


5050 


to 11 


to 307 


to 17 


844 


70 


6240 


to 22 


to 632 


to 27 



All values in the above table are octal. All values in the directives are assumed to be octal, but are interpreted 
as decimal if suffixed with a D. 

Each directive must begin in column one and end with a valid terminator. Valid control separators must appear 
between the elements of a directive. Successive allocation directives must refer to successive portions of a 
device; allocation directives may be intermixed with flaw directives. A maximum of 8 allocation directives can 
be provided. 
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ADDING DEVICES TO A DEVICE SET (ADDSET) 

The ADDSET control card establishes a master device and adds members to a device set. A master device, and 
therefore a device set, is created by ADDSET when the MP and VSN parameters indicate the same volume 
serial number. A member device is added to an existing device set when the MP and VSN parameters specify 
different volume serial numbers. A job that adds a member to a previously created device set must issue a 
MOUNT of the master device before the ADDSET is issued. The format of the ADDSET control card is: 

ADDSET (pl,p2, ... ,pn) 

The following parameters are required: 

MP=vsn Volume serial number of master device for set (1-6 alphanumeric characters, lead- 

ing zeros assumed). If MP and VSN parameters specify the same volume serial 
number, a master device is established. If MP and VSN specify different volume 
serial numbers, a member is added to an existing device set. 

VSN*vsn Volume serial number of device being added to the set (1-6 alphanumeric characters, 

leading zeros assumed). If vsn is the same for VSN and MP, a master device is 
established. If the vsn specified by the VSN parameter does not match vsn in the 
device label, a message identifying the device vsn is generated, and the job is 
terminated. 

SN=setname Name of device set created or the device set to which a member is added (1-7 

alphanumeric characters beginning with a letter). When a member is added, if the 
setname does not match the setname on the master device a message is generated 
and the job terminated. 

The following parameters are optional: 



NF=n 



NM=m 



Maximum number of permanent files that can exist on the device set. The default 
is 300. The value of n cannot be less than one nor so large that the permanent 
file tables do not fit on the master device. Tables must reside on the first DAM 
(RBR). This parameter has meaning only for an ADDSET of a master device. 

Maximum number of members allowed in the device set. The default is 50. The 
value of m cannot be less than one and cannot exceed 50 (decimal). NM is used 
by ADDSET to preallocate on the master device system tables for the member 
devices. For each member RBR, the system will need one PRU if the RBR is 
less than 62 words long, or two PRUs otherwise. ADDSET will reserve for system 
tables a number of PRUs equal to twice NM. If there are to be several RBRs for 
each member device, NM should be specified as somewhat larger than the actual 
number of member devices. This parameter has meaning only for an ADDSET of 
a master device. 



RP=ddd Retention period for the device set. The default is 31 days, ddd must be a 

decimal number (0 to 999) indicating the number of days before the device set 
expires. 999 indicates an infinite retention period. Thus parameter has meaning 
only for an ADDSET of a master device. 
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*PF Permanent files may reside on the member added to this device set. A device set 

may have members that can contain permanent files and members that cannot. 
Although the master device need not be a permanent file device, at least one 
device in the set must be. 

*Q Queue files may reside on the member added to this device set. 

DS Deadstart parameter, not available to users. 

EST-est EST ordinal specified at deadstart; not available to users. 

DELSET cannot be executed on a device set currently being shared. 

DELETING MEMBERS (DELSET) 

The DELSET control card deletes devices from a set. The master device must be mounted before the DELSET 
is issued. All member devices must be deleted before a DELSET is issued for the master device. Permanent 
files and local files residing on the device must be purged or returned before the DELSET is issued; if any 
portion of a local file or permanent file resides on the device to be deleted, the DELSET request is aborted. 
The format of the control card is: 

DELSET (SN=setname,MP=vsnl,VSN=vsn2) 

All parameters are required: 

SN=setname Name of the device set having the member to be deleted. 

MP=vsnl Volume serial number of master device of this device set. 

VSN=*vsn2 Volume serial number of member to be deleted from the device set. 

MAINTENANCE (RECOVER) 

The RECOVER control card is used to validate a device set and reconstruct critical tables. In a dual-mainframe 
system, it can also be used to recover space on a device set when one of the mainframes becomes inoperative. 

The format of the RECOVER control card is: 

RECOVER(SN=setname,VSN=vsn,L=lfnJk!FID=mfid,TERM^IODE=mode) 

setname Name of the device set to be processed. 

vsn Volume serial number of the master device of the device set. 

lfn Logical file name of the file on which any errors encountered in the validation 

process will be listed; default is file OUTPUT. When MODE =1 or 2, this 
parameter need not be specified and is ignored. 
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mfid 



TERM 



mode 



In mode 1, id of this mainframe. In mode 4, primary logical id of the mainframe 
that has become inoperative. When MODE = or 5, this parameter need not be 
specified and is ignored. 

Sequence number assigned to RECOVER by GENDJ for identification when 
RECOVER runs under the control of deadstart. When MODE = or 4, this 
parameter need not be specified and is ignored. 

Specifies mode of RECOVER processing: 

MODE=0 (default) 

- called by control card 

- runs only on an unmounted device set 

- performs a complete interlock cleanup 

- rebuilds the DAM using the LFT and the PFC 

- detects the RB conflicts 

- cross checks the PFD and the PFC 

- resets the available RB counts in the SMT 

- gives a comprehensive listing of all errors 

- flags the PFC entries for which RB conflicts have been detected 

MODE=l or MODE=DSRTIAL (First MF to Deadstart) 

- called by GENDJ at deadstart, which provides TERM parameter 

- runs only on an unmounted public device set 

- performs a complete interlock cleanup 

- rebuilds the DAM using the LFT and the PFC 

- detects the RB conflicts 

- resets the available RB counts in the SMT 

- flashes a message on the B display when an error is detected and either 
gives a GO option to the operator (non-fatal errors) or aborts (fatal errors) 

- calls HDS at the end of processing and transmits the TERM parameter 
value and the number of RB conflicts 

If the device set is being shared, the mainframe initiating the RECOVER 
must be the first mainframe in the multi-mainframe system to be brought up. 

MODE=2 or MODE=SECONDARY (Not First MF to Deadstart) 

- called by GENDJ at deadstart, which provides the MFID and TERM 
parameters 

- runs on a shared device set 

- performs interlock cleanup for local MF 

- rebuilds the DAM using the LFT and the PFC if the device set has not 
been mounted by another mainframe; otherwise, validates the DAM 
against the LFT and PFC 
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— detects the RB conflicts 

— flashes a message on the B display when an error is detected and either 
gives a GO option to the operator (non-fatal errors) or aborts (fatal errors) 

— calls HDS at the end of processing and transmits the TERM parameter 
value and the number of RB conflicts 

MODE=4 or MODE=CLEANUP (Resource Recovery) 

— called by control card 

— runs on mounted or unmounted device sets 

— performs a cleanup of the interlocks left by the inoperative mainframe 

— rebuilds (two mainframes) or validates (more than two mainframes) the 
DAM using the LFT and the PFC and the RBRs and RBTs of the host 
mainframe 

— detects the RB conflicts 

— gives a comprehensive listing of all errors 

MODE=5 or MODE=ERROR LIST 

— called by GENDJ to get a full listing of the errors detected during the 
preceding call to RECOVER in MODE 1 or 2 

— runs on mounted or unmounted device sets 

— validates the DAM against the LFT and PFC 

— detects the RB conflicts 

— cross checks the PFD and the PFC 

— gives a comprehensive listing of all errors 

— flags the PFC entries for which RB conflicts have been detected 



USING DEVICE SETS 

Once a device set has been created with the LABELMS and ADDSET control cards, it can be used by jobs. 
To access a device set, a job must issue a MOUNT control card. Then REQUEST cards with an SN parameter 
may be used to direct files to the device set. A file will be written on a system device unless a REQUEST 
card has previously directed that file to a device set. Files may be made permanent on a device set with the 
CATALOG control card. Files that were previously made permanent may be accessed with the ATTACH 
control card. The other permanent file control cards are applicable to device sets also. Except for REQUEST, 
the following functions are not available through macros. 



ASSOCIATING A DEVICE SET WITH A JOB (MOUNT) 

To access a device set, the user must issue a MOUNT control card for the master device. MOUNT is a logical 
operation; if the device is physically available, no operator intervention is required. If the device is not physi- 
cally available, the device name is placed in an operator display, and the job is swapped out until the device 
is mounted. 
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When the master device is mounted, the device set tables are read into the system and all files and member 
devices become logically accessible to the job. When the master is mounted, the system issues a MOUNT for 
other member devices as needed. The user also may issue a MOUNT for a member device. The format of the 
MOUNT control card is: 

M0UNT(VSN*vsn,SN=setnameJDS3ST»est) 

The VSN and SN parameters are required; DS and EST are specified only at deadstart. 

VSN=vsn Volume serial number of device to be mounted 

SN=setname Name of device set to which this device belongs 

DS Deadstart flag, used by operating system at deadstart to MOUNT public devices 

EST=est EST ordinal, used by deadstart 

For 844 (AY), MNT issues a stack request (with the factory data flag set) to read the pack serial number and 
manufacture date, and then issues a CE error file message containing the serial number and date. (If a parity 
error occurs or the factory data does not exist on the pack, the error file entry will contain a pack number of 
*NO S/N* and a date of 000000.) 

MNT processes the serial number and date only during the intiial MOUNT of the pack - not when the pack 
is mounted by subsequent jobs at other control points. 

The CE error file entry is described in detail in the Qn4ine Maintenance Software Reference Manual. 

DISASSOCIATING A DEVICE SET FROM A JOB (DSMOUNT) 

When a job has finished processing a user device set, the set may be logically disassociated from the job by 
issuing a DSMOUNT for the master device. If the user does not dismount the set, the system will do so at 
job termination. A dismount is a logical operation; other jobs using the same device set will not be affected. 
DSMOUNT also may be issued for a member device. 

When a DSMOUNT specifying the master device of a private device set is executed, a close unload is issued 

for every file in use by the job and residing on the user device set, each mounted member device is dismounted, 

and finally the master device is logically dismounted. DSMOUNT is inoperative on public device sets. 

The DSMOUNT control card has the format: 

DSMOUNT,VSN«vsn3N=setname. 

Both parameters are required and have the same meaning as for MOUNT. 

DIRECTING FILES TO DEVICE SETS (REQUEST) 

The REQUEST card must be used to direct files to specific device sets. All files are written on public devices 
unless a REQUEST card with the SN parameter has previously directed the file to a specific device set. 
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The format of the REQUEST card follows: 



REQUEST (lfn, JSN=xxx) [ > ov,PF ) VSN=yyy,dtaa]J 



The meaning and use of the parameters are described in the SCOPE Reference Manual. Note that the EC 
parameter cannot be specified on this form of the REQUEST card. 



IMPLICIT REFERENCE TO DEVICE SETS (SETNAME) 

The SETNAME control card indicates the device set to be referenced implicitly by subsequent control cards. 
Before a SETNAME card is executed, system devices are used unless a device set is explicitly specified. Once 
a SETNAME control card is executed, the specified device set is implicitly referenced by following control 
cards. A second SETNAME control card overrides the first. When no device set is specified on the SETNAME 
card, the system devices are assumed. The only control cards affected by a previously executed SETNAME are 
REQUEST cards with an unequivalenced SN parameter and permanent file control cards. The format of the 
SETNAME control card is: 

SETNAME(setname) or SETNAME. 

setname Device set to be referenced implicitly. The master device of this set must be 

mounted before SETNAME is issued. 



ADDRESSING PUBLIC SETS BY SET ATTRIBUTE 

A standard FDB is used by the system to return the device set name of public sets by attribute. 

The calling sequence is as follows: 

SYSTEM FSN,R,fdbadd,code*100B 

where 

FSN Program name 

R Recall (mandatory) 

fdbadd Address of FDB into which the correct SN should be placed. A dummy SN 

should be used when creating the FDB. 

code Set to find 

- system 

1 = pf default 

2 - queue 

3 = (reserved) 

FSN will place the set name in the SN parameter slot and set the FDB complete bit. FSN will abort if no 
set exists except for code 3 where a scratch set will be assigned if no buffer set can be found. 
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JOB PROCESSING 



JOB FLOW 

SCOPE processes jobs in the system in three sequential, independent stages: Input. Scheduling, Output. 
Many jobs may be in any one of the three stages. 

Jobs can be loaded into the computer by reading card decks into the system using the system package JANUS. 
Alternately, they may be input from tape with the tape loader or from a user terminal* through INTERCOM. 
When the job has terminated, JANUS is assigned to process the OUTPUT, PUNCH, and PUNCHB files pro- 
duced by the job. 

A job comes under scheduler control after all system resources specified on the job card have been assigned 
to it. When a job is under scheduler control, it has an assigned job description table entry and is in one of 
the scheduler queues; or it has been assigned to a control point. When it is assigned to a control point, the 
control point status values will indicate either the type of activity or that activity at the control point has 
been suspended. With the job swapping/rolling features of SCOPE 3.4, several jobs may be considered to 
be assigned to each control point. 

A job is in execution only when it is assigned a control point and central memory and is actively using a 
central processor. Then SCOPE executes the job as directed by the control card record of the job's input file. 

JOB INPUT QUEUE 

As each job is read into the computer by JANUS, the tape loader, or INTERCOM, it is placed into the job 
input file and a FNT entry for the job is created in the job input queue. 

JANUS and INTERCOM call the PP overlay 2VJ to translate the JOB control card. 2VJ scans die card, 
checks the parameters for validity, computes a priority value for die job, determines the job class, and passes 
all this information back to the PP program which called it. TLOAD, the tape loader, and other CP programs 
call DSP to enter a job into the INPUT queue. 

The PP program 1IB scans the job input queue, looking for jobs eligible for execution scheduling. To be 
eligible, a job must have all resources requested on the job card, except for central memory. A job will remain 
in the input queue if it is dependent on a job which has not run, if it is waiting for operator tape staging, 
if the job is not to be brought to a control point, or if the amount of ECS it requested is not available. 
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TAPE JOB SCHEDULING 

All incoming jobs requiring a specific number of 7 and/or 9-track tapes (as defined by MT or NT parame- 
ters on the job card) are entered in the pre-input queue, a subset of the input queue. The operator commu- 
nicates with the pre-input queue through DSD type-ins and the P display. Each time the operator requests a 
P display, the jobs displayed are the highest priority tape jobs in the queue. A job requiring topes is not 
placed in the normal job input queue until the operator releases it with a type-in. Once released, the job will 
be considered for assignment to a control point and execution: it no longer appears in the prescheduling 
display. Tape drive scheduling is described in Section 4 under non-allocatable devices. 

LOADING JOBS FROM TAPE 

The CP routine TLOAD is used to load jobs onto disk via magnetic tape. TLOAD is called to a control point 
by DSD when the operator initiates a keyboard entry in the format: 

n.X TLOAD,g,p. 

n is the number of the control point to be used. 

g is an optional parameter specifying the number of the file group to be loaded. 

p is an optional parameter specifying the number of the job in file g to be loaded. 

Both g and p are decimal digits. Numbering begins with one, not zero. 

A file group is a collection of jobs on tape, terminated by a double end-of-file. 

A standard circular buffer technique is used to process input files. The first card of the first record in each 
file is presumed to be a JOB card, and it is processed accordingly. This assumption is made for each job on 
the tape. CIO and its overlays are called to read the tape into memory and write memory to disk. 

The number of control cards which may appear in a given job is not limited. If the user fails to place an end- 
of-record (7/8/9) card behind the control card record of a job, the omission will not be detected by either 
TLOAD, JANUS, or INTERCOM until the job runs. 
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JANUS 

The unit record I/O package - JANUS - consists of the following PP programs: 



IIQ 

us 

1IR 
1IU 
1PL 
1FM 



Input/output queue manager; sets up a control point to read jobs 
from card readers and to print or punch job output files; handles 
DSD type-ins and displays 

Called by IIQ to load a group of overlays into the field length for 
use by 1IR 

Card reader, card punch, and printer driver 

Called by 1 IR to backspace print files when necessary 

Dummy output file driver for plotter 

Dummy output file driver for film/hard copy devices 



Display 
Driver 



Input Queue 

Output Queue 

Manager 




Card Reader/Punch 
and Printer Driver 



Backspace 
Print File 



Initialize 

JANUS 

Control Point 



/ 1FM J Film Driver (dummy) 



Plotter/Hard Copy 

Driver 

(dummy) 



JOB Card 
Translation 



JANUS Interfaces 



60306500 E 



7-3 



INTEGRATED SCHEDULER 

The job scheduling scheme implemented in SCOPE 3.4 is made up of the following: 



Scheduler 

(MMGR) CPU program operating at control point zero in 2-to 3-millisecond cyclical intervals. It 

allocates control points and central memory to jobs and determines which jobs should 

be swapped/rolled in and/or out. 

1IB Brings jobs from input queue to CM queue; builds JDT entries for jobs. 

1RN PP program operating at control point zero at about one-second intervals. One of its 

functions is to age jobs in the input and output queues. 

Swappers PP programs called to swap or roll jobs in (1SI) or out (ISO) and to initiate new 

INTERCOM jobs. 

1DM PP program which processes job entries in the device queue. 

1PF PP program which processes job entries in the permanent file queue. 

1CI PP program which processes job entries in the INTERCOM queue. 

iqp PP program which processes multi-user job entries in the INTERCOM queue. 
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INTEGRATED SCHEDULER INTERFACES 
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59 



47 



T.XPIDLA I" 



35 



29 



14 



W.CPUST/W.CPSLIC 
W.CPTIME 
W.CPTIMB 
W.PPTIME 
W.XPIR 
W.XPOR 

Scheduler Only 
T.SCHRS 

T.MTRRS 



Exchange Package 
for Scheduler 



C.CPSTAT 



C.CPSLIC 



C.CPLINK 



CPU-A Scheduler Time 



CPU-B Scheduler Time 



PPU Idle Time 



Scheduler Input Register 



Scheduler Output Register 



Integrated Scheduler 
Request Stack Table 



L.SCHRS=4 



CPMTR MTR Request Stack 



L.MTRRSM 



i 



1 



17 
20 

21 

22 

23 

24 

25 
26 



31 
32 



35 



SCHEDULER REQUEST STACK IN SYSTEM EXCHANGE PACKAGE AREA 
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JOB SCHEDULING 

In SCOPE 3.4, user jobs in execution can be either swapped or roiled in or out of central memory by the 
integrated scheduler or by the operator. This feature of the job scheduling scheme allows dynamic alloca- 
tion of control points and central memory. If the scheduler needs a control point or central memory, it need 
not wait for a job to terminate. Such a scheme permits more efficient servicing of a mixed group of jobs, 
such as INTERCOM, remote batch, local batch and time-critical. System jobs such as JANUS and 
LOADER can not be swapped or rolled. 

ROILING 

A job will be rolled out instead of swapped out under the following conditions: 

Job has direct-access ECS assigned 

Job has non-allocatable equipment assigned 

Job is in device queue 

Job is in operator action queue 

Job's field length plus its required positive field length for swapout exceeds IP.MFL (maximum field 
length a job can request) plus IP.POSFL or 13 IK, 

When a job is rolled out, its field length is written to an allocatable file and all of its memory, except RA + 
through RA + 77, is released. The control point remains assigned to the job and its JDT entry is placed in 
the appropriate queue. When a job is rolled in, it begins active use of its control point. 
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SWAPPING 

A job is swapped out under the following conditions: 
Job is waiting for CM 
Job is in permanent file queue 
Job is waiting for permanent pack 

Job is waiting for INTERCOM or graphics terminal I/O (job is in INTERCOM queue) 

I Job is waiting for multi-mainframe action 

When a job is swapped out. all information concerning the job is written to an allocatable file. This 
information includes the job field length, control point area, dayfile buffer, dayfile pseudo FET, FNT entries 
assigned to the control point, and entries in the PP event stack and delay stack. Both the control point and 
central memory are released and made available for reassignment. The JDT is placed in the appropriate 
queue: it contains a pointer to the swap file containing the job. The job. when swapped in, may be assigned 
a different control point and a different area in central memory. 

The scheduler can be initiated by a PP program using a M.SCH or M.ICE monitor request. The scheduler is 
called in the following cases: 

1 . When a PP program has an entry to be added to the central memory queue, the scheduler will determine 
if the job has a priority high enough to cause any programs to be swapped out. If so, the scheduler 
initiates the swap-out and assigns the job to a control point. Otherwise, the scheduler adds the entry to 
the central memory queue. 

2. When the field length of a job executing at a control point is reduced, the scheduler is called to search 
the central memory queue for a new job to be scheduled. 

3. The scheduler is called periodically to determine if any job assigned to a control point has completed its 
quantum time period for CP and/or PP and if any jobs in the central memory queue have been aged 
enough to cause a swap-out. A job will be swapped out during its quantum time period only if a job 
with a very high class priority entered the central memory queue. 
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JOB CONTROL AREA 

Jobs entering the system for execution are placed into one of six classes: 

1 . Batch jobs using no non-allocatable resources 

2. Batch jobs using one or more non-allocatable resources 

3. INTERCOM (interactive) jobs 

4. Multi-user jobs 

5. Expressjobs (for which operator has entered DROP. KILL or RERUN) 

6. Graphics jobs 

An entry for each job class appears in a CMR table called the job control area. Each entry contains 
parameters affecting the scheduling of jobs in that class. These parameters include: 

Minimum queue priority 

Maximum queue priority 

Aging rate (time) for incrementing job priority 

Quantum priority value 

Quantum time length value 

Pointer to first JDT in job class scheduling chain 

When a job is swapped out, it is given a queue priority value equal to the minimum queue priority for its 
class. This value is incremented with time at the aging rate for the class. When the incremented priority 
value reaches that of the. maximum queue priority for the class, aging stops. 

When a job is swapped in, it is given a queue priority value equal to the quantum priority for the class. 
When the quantum time length for the class has elapsed, the job priority is set to the minimum priority for 
the class. 

A system operator can control job swapping overhead by adjusting the quantum time lengths for the 
different job classes in the job control area. Special DSD commands and display allow the operator to 
adjust the job control area parameters. 

The pointer to the job control area is T.SCHJCA which is in byte C.JCA of word P.SCH of the CMR pointer 
area. The format of the job control area appears in part II, section 1. 

A description of die .scheduling parameters appears in section 1-1 of the SCOPE 3.4 Installation Handbook. 
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JOB DESCRIPTOR TABLE 

Each job to be scheduled for execution, has a job descriptor table (JDT) entry containing information 
pertinent to its scheduling. If a job is not active at a control point, its JDT must be in one of the scheduler 
queues. Each job JDT in the CM queue is linked into one of the six job class scheduling chains originating 
in the job control area. A linking pointer to the next JDT in the chain appears in the first word of the JDT. 

Entries in one of the job class scheduling chains of the CM queue are linked in order of their entry into the 
chain. Each entry contains the time when it was added to the chain. The current priority of an entry is 
computed by multiplying the length of time the job has been in queue by the aging rate for its class and 
adding the minimum class priority. Job JDT entries in the permanent file queue are also linked; JDT 
entries in other queues are not linked. 

The job status code in the JDT is of prime importance. When a job is assigned to a control point, its JDT 
ordinal is in byte 4 of word W.CPJNAM in the control point area. If a job is not assigned to a control 
point, its status code in word W.JDMGR of the JDT indicates it to be in one of the following job 
scheduling queues: 

Central Memory Queue 

Device Queue 

Permanent File Queue 

Permanent Pack Queue 

Operator Action Queue 

INTERCOM Queue 

Multi-mainframe Queue 
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JOB SCHEDULING QUEUES 

CENTRAL MEMORY QUEUE 

The CM queue is made up of jobs waiting for central memory and control point assignment. They are 
rolled/swapped jobs waiting to be reassigned a control point and/or central memory. 

The PP routine 1 IB scans the job input queue for jobs to be assigned to a control point. When such a job is 
found, I IB creates the JDT entry and requests scheduler to set the entry in the CM queue. Jobs in other 
scheduling queues, such as the permanent file queue, for which requested action has been completed also 
are eligible to re-enter the CM queue. 

DEVICE QUEUE 

If a job executing at a control point requests a tape that must be mounted, the REQ routine will put the 
JDT into the device queue and call a swapper to roll out the job. The PP program ITS is responsible for 
detecting when the requested device is ready and for calling the PP program IDM to put the JDT entry 
back into the CM queue. When the job is rolled back in. REQ will be recalled to create a FNT entry for the 
file. 

Pseudo channel CH.SCH is used as an interlock in the device queue. Jobs in the queue are rolled out rather 
than swapped out so that the message to the operator will appear on the B display. 

PERMANENT FILE QUEUE 

When a job executing at a control point makes an ATTACH request for a permanent file, the PP routine 
PFA is called. If PFA determines that the file cannot be attached and that the job will have to wait, it places 
the JDT entry into the permanent file queue and calls a swapper to swap out the job. 

Whenever an attached permanent file is detached, 1PF is called. It checks the permanent file queue for jobs 
waiting for the detached file. If any exist, 1PF will select the highest priority waiting for the file and call the 
scheduler to put its JDT back into the CM queue. When the job is swapped back in. PFA will be called to 
attach the permanent file to the job. 

If a permanent file is purged, the PURGE routine will search the permanent file queue and call the 
scheduler to put all jobs waiting for that file back into the CM queue. As each job is swapped in. PFA will 
be called. It will detect that the file has been purged and respond accordingly. 

All entries in the permanent file queue waiting for a given permanent file will be linked together in order 
of priority. The APF table entry for the file will contain a pointer to the first JDT entry in the chain. When 
PFA adds an entry to a chain in the queue, it will age all entries in the chain and insert the new entry. 
Pseudo channel CH.PFM will be used to interlock the queue. 

If a job requests a permanent file to be attached with read-only permission and the requested file is already 
attached to a job with multi-read access, the requesting job can attach the file only if it has a higher priority 
than any job in the permanent file queue waiting to attach the file. 
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OPERATOR ACTION QUEUE 

When a job makes an operator action request, its pause bit is set in the control point area, its JDT entry is 
placed into the operator action queue, and then it is rolled out. Such jobs are rolled out rather than swapped 
out, so that the message to the operator will appear on the B display. Whenever the scheduler finds a job 
pause bit set, it calls a swapper to put the job in the operator action queue, unless the PP routine processing 
the request indicates the job is to be put into some other queue. For example, REQ will set the pause bit 
and then request the job to be put into the device queue rather than the operator action queue. 

When the operator takes appropriate action, the job is again eligible for the CM queue; it will be rolled in 
and initiated at its control point. 

INTERCOM QUEUE 

Jobs waiting for input from an interactive INTERCOM or graphics terminal or waiting until output can be 
sent to a terminal are swapped out and put into the INTERCOM queue. 

JOB ADVANCING 

When the scheduler has set up a job at a control point, the job advancing routine 1 AJ is called into a PP. 
1AJ reads one PRU of data from the control card record of the job's INPUT file into the control card 
buffer in the control point area, starting at location W.CPAF. Since the file INPUT is on an allocatable 
device, one PRU will be 100 CM words long and will extend to location W.CPCAL in the control point 
area. If the control card record has more than one PRU, 1AJ stores the INPUT file FST entry for the next 
PRU of the control card record in word W.CPFST in the control point area. 

The job card has been processed by the routine 1TJ; 1AJ scans the control card buffer for the card 
following the JOB card. When it is found, IAJ sets a pointer in word W.CPCC of the control point area to 
the next control card and then processes the first card found. The processing sequence for control cards is 
illustrated in figure 7-1 . 

When the first control card has been processed, IAJ is loaded again. Using the next-control-card pointer, it 
will read that card from the buffer, delineate the next card, set the pointer to the next card, and then process 
the control card just read. When all cards in the buffer are processed, IAJ reads another PRU from the 
INPUT file control card record into the buffer and resets the next-control-card pointer to the beginning of 
the buffer. 

IAJ continues to process control cards until all have been processed, the job is terminated because of error, 
or an EXIT card is encountered. 
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CONTROL STATEMENT PROCESSING 

When 1AJ begins to process a control statement in the control point buffer, it first tries to match the keyword 
with a list of names that it treats as special cases. If there is a match, 1 AJ completes the processing of the state- 
ment and looks for another statement in the buffer. If the verb is not a special case name, 1 AJ next checks 
whether the keyword is the name of a local file. If it is, the statement is cracked; that means, it is issued to the 
day file, copied to RA + 2 (RA.ARG) through RA + 54, and finally the loader is loaded to perform the load of the 
file. If the keyword is not a local file name, 1 AJ next checks whether the keyword is a control card callable PP 
routine name. If it is, the parameters are separated and put in RAARG, the statement is issued to the dayfiles, 
the first two parameters are converted to binary and stored in bits 35 through of the input register (except for 
the routine VSN) and finally the PP routine is loaded on top of 1 AJ. If in turn the keyword is not a PP routine 
name, 1 AJ sequentially searches the CM resident global library set to see if there is a control card callable entry 
point with the same name. If there is, and the program is an absolute overlay, 1 AJ itself cracks the statement, 
loads the program at RA + 100 (RA.ORG), and starts it up. In any other case the loader is loaded to find some- 
thing to load and execute. 

The special case names recognized by 1AJ and the processing for each name are as follows: 

COMMENT The comment card, less the keyword COMMENT, is issued as a dayfile message. If the message 

is longer than 40 characters, it is issued in two parts. 



MODE 



The exit mode is set as specified on the MODE card. If the mode value is greater than 7, a 
control card error message is issued. 



LIMIT 



This card sets a limit on the amount of mass storage that can be allocated to the job. The value 
is given as a decimal number of 4096 CM-word blocks and is stored in the control point area, 
word W.CPMSLM, as the mass storage limit in number of PRUs. If the job does not contain 
this card, an installation defined value (IP.SMS) is used. A running PRU count is kept in the 
same control point word; if the limit is exceeded, the job is terminated. 



SWITCH The parameter value causes a corresponding bit to be flipped in the C.CPSSW byte of word 

W.SSW in the control point area. 



RFL 



The new field length value is set in byte C.CPNFL of word W.CPCC and the reduce bit is cleared. 
The new field length must not exceed the field length given on the job card or the current 
value in C.MFL or P.MFL. 



SUMMARY The overlay OV.6BM is loaded to issue job statistics to the dayfile. 

LOGIN Entries to dayfile are suppressed before loading this routine, bypassing the FNT search. 
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JOB TERMINATION 

NORMAL TERMINATION 

Normal job termination occurs when the error flag value is zero, and all control cards for the job have been 
processed (an end-of-record mark for the control card record on the job INPUT file has been read) or when 
any form of EXIT card (except EXIT.U. or EXIT.C.) has been encountered. The end-of-job processor, 1EJ, 
is called by 1AJ to terminate the job as follows: 

1. Dispose of all files associated with the job as follows: 

Drop local files on system devices and all equipment or storage associated with them. 

Attach nonzero disposition files to control point zero for further processing of output files. 

Update the TAPES table; rewind and unload tapes as appropriate. 

When tape scheduling is used, return reserved tapes to the system pool. 

Call overlay IPC for disposal of permanent files and local files on user device sets. IPC will call 
DSM if private sets are associated with the job. 

2. Transfer the job dayfile to the OUTPUT file associated with the job. 

3. Release storage for the job, set the job name to NEXT. The clear bit will be honored by scheduler when 
it clears the control point area. 

Files are disposed of as follows: 

PERMANENT FILES 

Each time a permanent file is to be disposed of, an entry is made in a list to be processed by IPC. IPC will 
delete the FNT/FST entry for the file. The file will still exist on a mass storage device. The APF entry for 
the file will be updated or deleted, as appropriate. A purged file is no longer permanent and is processed like 
any other mass storage file. 
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INPUT FILE 

The job input file is not dropped until after the dayfile has been transferred to the job OUTPUT file and 
the OUTPUT file has been released to JANUS. Then the disk space for the job input file is evicted and its 
FNT/FST is cleared. 

OUTPUT FILE 

After the dayfile has been copied to the job OUTPUT file, the OUTPUT file FNT is modified so that the file 
name is replaced by the job name, and the file is assigned to control point zero and rewound. The file is then 
released for processing by JANUS. 

If the output file is on a non-allocatable device or pack, the equipment is dropped and the FNT is zeroed be- 
cause JANUS cannot process files on non-allocatable devices. 

If the file is on an allocatable device, the FNT is rewritten so that the file name is replaced by the job name, 
and the file is assigned to control point zero and rewound; its disposition code is retained. For INTERCOM 
batch files, the user ID is picked up from the control point area and stored in the FNT. 

OTHER FILES 

If the file is on a non-allocatable device, the equipment is dropped. If the file is on an aliocatable device, the 
file space is evicted. In either case, the FNT/FST entry is cleared. IPC disposes local files residing on private 
device sets. 



DAYFILE 

After the dayfile has been copied to the job OUTPUT file, its FET is reset. If part of the dayfile is on disk, 
the disk space is released and its FST is cleared. 

PACK QUEUE 

If a job attempts to MOUNT a member of a device set and the device is not on-line, the job will be swapped 
out or rolled out (operator initiated jobs will abort). When the device being requested is ON and FREE, all 
jobs waiting for the pack will be returned to the CM queue. 

Routine 1PK is responsible for processing the queue. If the request for the device is generated by an I/O 
request, the I/O function continues from the point of interruption. 
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ABNORMAL TERMINATION 

Abnormal termination of a job occurs when error flag value is non-zero. If the error flag value is other than 
KILL (value 7) or RERUN (value 10), 1EJ will dump the contents of the exchange package and the contents 
of memory in addition to doing the normal termination processing described above. The dump includes 
from 100 words before the error stop through 100 words after it (P-100 to P+100) and is written to the 
OUTPUT file immediately preceding the job's dayfile. A dayfile message describes the error. If an error flag 
value other than KILL or RERUN occurs and an EXIT, EXIT(S), or EXIT(U) card follows in the control 
card record, 1AJ will resume job processing after that card is encountered. If an EXIT(C) card is encountered 
prior to an EXIT, EXIT(S), or EXIT(U) card, under the conditions mentioned above, the job will terminate at 
that point. 

If abnormal termination occurs as the result of an ABORT macro call, job processing will proceed in accord- 
ance with the ABORT call parameters as discussed in the SCOPE 3.4 Reference Manual. 

If the operator has killed the job, the error flag value is set to 7. Permanent files are processed as for 
normal termination. The FNT is zeroed and disk space or equipment is released for all other flies, including 
output and non-zero disposition files. JOB KILLED is issued to the system dayfile, the control point area is 
reset and the job name is cleared. No output is produced for killed jobs. 

If an operator has typed a RERUN command, the error flag value is set to 10 and the job input file is 
returned to the job input queue. Permanent files and family disk pack files are processed as for normal 
termination; all other files are dropped. A pre-output file is created as a local file to control point zero; it is 
not rewound; it has a file name which is the same as the job name. The dayfile is copied to the pre-output 
file, which becomes the output file for the job when it is rerun. 
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JOB POST-PROCESSING UTILITIES 

During execution o! a user program, various errors, such as arithmetic mode error or exceeding time limit, 
may cause the program and the job to terminate abnormally. At this point, the operating system will place a 
message in the day die. dump the exchange package and central memory (100 words on each side of the 
error stop location) and either resume the job processing at an EXIT or EXIT(S) card or terminate the job. 

At the request of the user, the operating system will return control to the job after normal termination or 
after an error condition is detected and before EXIT card processing is performed. At that time, the system 
will return control to a user supplied post-processor routine which will print out data in appropriate format, 
etc. The user's post-processor routine may specify procedures to be performed after normal or abnormal job 
termination. 

REPRIEVE 

The reprieve function RPV is a PP program called by the user and by 1AJ. It allows the user to receive 
control at a location inside the job field length after program termination, at which time a cleanup/recovery 
routine may be executed. 

The user should call RECOVR during the job initialization phase, at which time the RPV call, generated by 
RECOVR as follows, is placed in RA+1: 

VFD 18'3HRPV,6/20B,13/ma8lc,24/fi»a 



RPV 



Is the PP routine name 



20B 



Sets the CPU in auto-recall 



mask 



fwa 



Is a bit list of error classes for recovery 

Is the first word address of the recovery routine in the user job 



System Error 

Normal termination 

Requested time limit exceeded 

Arithmetic mode error 

PP program requested abort (M.ABORT) 

CP program requested abort 

Attempt to call illegal PP routine 

Operator dropped control point 

Operator KILL 

Operator initiated rerun of job 

CP abort (ABT+bit 36) skips to EXIT(S) cards 

ECS parity error 

Required auto-recall status missing 

Job hung in auto-recall 

Required mass storage limit exceeded 

xxx not in program library 

I/O time limit exceeded 



tor Code 


Reprieve Mask 


(octal) 


(octal) 





100 


1 


004 


2 


001 


3 


020 


'. 4 '■ 


040 


5 


002 


6 


010 


7 


010 


10 


010 


11 


040 


12 


020 


15 


002 


16 


002 


17 


004 


20 


002 


21 


004 
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Job term in;iiion.s are divided into classes; each class is assigned an octal value which may be specified singly 
or in combination lo form the mask generated as pan of the call. The values are: 

(MIDI Arithmetic mode error 

0002 RA + 1 error (PP call error, auto-recall error; PP name unknown) 

0004 Time and/or storage limit exceeded 

0010 Operator drop, kill, or rerun 

0020 System abort (PP abort; ECS parity error; illegal PP parameter) 

0040 C'P abort 

0100 Normal termination 

The lirst word address points to a 17-word (decimal) block which will receive the exchange package and 
RA + I contents. Control is returned to l'wa + 21. 

Upon a user call to RPV. if the value of the upper 30 bits of the word at fwa is non-zero, it is assumed to 
be the last word address of the recovery routine in the user's job. A checksum of the area fwa + 21 to Iwa 
will be made and the sum stored in fwa+ I. 

The call to RPV by IA.I occurs when 1AJ is entered with reprieve mask non-zero. 1AJ calls RPV with 
bit 41 of the input register set to one. 

Upon exit from a user call to RPV. the mask and fwa fields of the call will be stored in the control point 
area, in word W.CPCC. The contents of the word at fwa will be cleared; and if a checksum was performed, 
fwa+ I will contain the sum. 

Upon normal exit from a call by 1AJ, the mask in the control point area will be cleared, the exchange pack- 
age with the error flag set in register B0 will be in fwa to fwa + 17, and the contents of RA + 1 will be in 
the next word, fwa + 20. The system guarantees an installation defined minimum amount of time and mass 
storage for reprieve (and EXIT) processing. The CP time limit, 10 time limit, and mass storage limit are each 
set to the larger of their current value or the sum of the amount used and the guaranteed minimum. No limit 
is allowed to be increased more than once per job. 
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RECOVR 

The central memory program RECOVR is an interface between user program and operating system for 
users who wish to gain control at the end of a job step, regardless of the manner in which it terminated. 
RECOVR should be called during the initialization phase of the job. at which time the address of the post- 
processing routine is given. RECOVR formats the arguments in the call into a stack entry, checksums the 
user post- processor routine if requested, saves the checksum in the stack, and then calls the PP program 
RPV to inform the system that the job should be restarted in case an error occurs. 

When the system detects an error condition, it will issue two messages to the dayfile: the first will report the 
error condition and the second will report that the job has been restarted only if flags set in RECOVR call 
match those that cause the abort. It will give control to RECOVR along with the contents of the exchange 
package and RA + I and the code for the condition that caused the system to stop program execution. 
RECOVR will call the post-processor program in a last in-first out order of calls in the entry stack and pass 
to it the address of the array area in which the exchange package, RA + 1 contents and system error code 
has been placed. Upon termination of the user's post-processing routine, RECOVR will make an abort 
request to the system so that EXIT card processing will follow, unless the post-processor has specified that 
the program be terminated normally. 

The calling sequences for RECOVR: 

FORTRAN: CALL RECOVR (name, flags, checksum) 



COMPASS: 



RECOVR name , flags , checksum 



name 



Name of the user routine to which control is returned after a 
system abort 



flags 



Octal value specifying condition under which control is to be 
returned. 





001 


Arithmetic mode error 




002 


RA+I error 




004 


Time/storage limit exceeded 




010 


Operator drop or rerun 




020 


System abort 




040 


CP abort 




100 


Normal termination 


checksum 


Should be zero fc 


>r no checksumming: otherwise, 



last word address +1 of the recovery program to be 
checksummed. 
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The user post-processing routine to which control is returned by RECOVR should provide for three argu- 
ments. ( 1 ) The address of a 1 7-word array to receive the contents of the exchange package upon abort in 
the first 16 words and the contents of RA+ I in the 17th word. (2) A flag to indicate normal (ENDRUN) 
termination of the job or abnormal (ABORT) termination after post-processing is completed. A non-zero 
value indicates normal termination. (3) An address of a word to contain the contents of RA+ 1. If the P 
register contains zero in the exchange package, the address of the program error stop will be returned in 
bits 30-47 of RA+O. 

Under no circumstance should the post-processor routine store into or modify the contents of the first 
argument. 

The system error code is returned in bits 0-17 of word 1 of the first argument. The codes are explained in the 
REPRIEVE section. 

If the user program is executed in overlay mode, both the call to RECOVR and the post-processing routine 
should reside in the 0,0 level overlay. 

When the system stops normal execution because the job time limit has been exceeded, the time limit will 
be incremented by a value set per installation option so that the post-processing routine can be executed. 
Post-processing of an error condition should not be confused with OWNCODE (user processing of parity 
errors); the two concepts are not related. 
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JOB CONTROL WITH LOGICAL IDENTIFIERS 

Logical identifiers specify logical groups or functions. They allow extended control over job initiation and 
job/tile processing, especially when the environment is a multi-mainframe system. The ID table, resident in 
central memory, contains the information needed to process logical identifiers (LIDs). The ID table may have 
a length of zero, in which case LIDs will not be allowed by the operating system. For a single operating 
system, the LIDs can be used, for instance, to group all the jobs for a special printer. Those jobs must enter 
the system with the same logical ID. Only when the special printer is available may the operator place the 
logical ID in the system's ID table and allow the group of jobs to execute. 

A mainframe, in this discussion, is a hardware configuration controlled by a dedicated operating system. A 
linked mainframe communicates with a mainframe other than itself, and a multi-mainframe system consists of 
linked mainframes. Each linked mainframe in a multi-mainframe system communicates with the other main- 
frames. The ID table contains the name of the host mainframe (host ID), the logical IDs associated with the 
host mainframe, and the names of the other linked mainframes (physical or link IDs). A physical ID stored 
in the ID table is identical to the host ID of one of the other linked mainframes. For example, in a multi- 
mainframe system consisting of two linked mainframes, one could have an ID table listing a host ID of MFA 
and a physical ID of MFB, and the other would then have an ID table listing a host ID of MFB and a physical 
ID of MFA. 

The host iDs and logical IDs consist of three letters or digits. The host ID in a multi-mainframe system is 
unique, because the third character of each host ID must be unique and must be a letter. As many as 58 
decimal LIDs can be associated with the host mainframe. 

If a single mainframe system is operating with an ID table of zero length, a job/file which does not specify 
a logical ID is processed on that system. Specification of a logical ID causes the system to flag the control 
card error and terminate processing. 

If a single mainframe system is operating with an ID table containing the host ID and the list of associated 
logical IDs, job/files which do not specify a logical ID are processed on that system. Job/files which specify 
a logical ID cause the system to inspect the, ID table for a matching logical ID. If a matching LID is found, 
the job/file is processed. If no match is found, processing waits until the operator places the specified LID in 
the ID table and the match is found. 

If a multi-mainframe system is operating, an ID table exists for each linked mainframe. Job/files which do not 
specify a logical ID are processed by the host system. Job/files which specify a logical ID cause the host system 
to inspect its ID table. If a match is found in the list of LIDs, the job/file is processed on the host system. 
If a match is not found, the host system uses the physical IDs in its ID table to seek a match for the LID. 
If a match is found, the job/file is processed by the appropriate linked mainframe. If a match is still not 
found, the job/file waits in queue on the host system until a match for its logical ID is found either for the 
host system or for a linked mainframe system. 
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INTRODUCTION 

The purpose of EDITLIB is to: 

Create deadstart tapes 

Create and maintain system libraries 

Manipulate the running system to effect temporary changes 

Modify the running system or the deadstart tape by merging in permanent changes and creating a 
new deadstart tape. 

Create and modify a user library consisting of a group of central processor routines or overlays. 

Assuming the user is starting from scratch, the user obtains an unconfigured deadstart tape from Software I 

Manufacturing and Distribution. This tape contains the binary decks of the entire SCOPE operating system, 
to be used to build a new system. EDITLIB is then called by selected control cards and directives to mod- 
ify the current system after the approprate assemblies and compilations have been performed. Thus a new i 
deadstart tape and/or running system can be created which reflects the system as it is physically configured. 
(See figure 8-1). 

It is not required that all system code be located in one massive system library. Object code can reside in 
either a system library or a user library. Thus EDITLIB can be used in two distinct forms: system EDITLIB, 
which is discussed in this section; and user EDITLIB, which is contained in the SCOPE 3.4 Reference 
Manual. 

System EDITLIB can also function like user EDITLIB; directive statements before the first READY, or 

after the last COMPLETE, or between a COMPLETE and the next following READY, are interpreted as they , 

would be in user EDITLIB. 

All read and write operations required by EDITLIB are accomplished by RA+1 requests to CIO only; I/O 
macros or other means are not used. EDITLIB can handle object code only of the type processed by the 
CDC CYBER loader; 7000-type object code cannot be processed. All object code for EDITLIB input must 
be in SCOPE logical format, having a zero-byte terminator. Object code in W-type (word count) records 
such as that produced by the Record Manager, or in S, X, L, or other non-SCOPE format tapes cannot 
be processed by EDITLIB. 
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Figure 8-1 . Basic Usage of System EDITLIB 
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CHARACTER SET 

The EDIT/LIB character set is that which is supported by SCOPE 3.4. EDITLIB will interpret the 
S ( ) = + - * / , and . as delimiters. Blanks are free characters and will be removed. From the charac- 
ter set, the user is able to create: 

1 . Symbol - a single character or a string of characters 

2. Vocabulary Word - a symbol that has meaning as defined by the semantics. 

3. Name - a symbol that is defined by syntax and semantics. 

When any delimiter and/or a blank is used to form a symbol, the symbol must be enclosed between $ signs, 
(see Example 1 ). When a $ is to be used as a character within a symbol, an additional S must be written 
immediately adjacent to each S desired. The only character that will be removed is the first $ of each pair 
of S encountered. (See example 2.) 

Whenever a name could be interpreted as a number or a vocabulary word, the name should be enclosed 
between S signs. 

Examples: S-DSD—S 

Symbol is -DSD— 
SD$SIS$$$$$--S 
Symbol is D$I$$$~ 
SSSCIOS 
Symbol is SCIO 

The input to EDITLIB is the first 72 columns of an 80 or 90 column card image. A directive must be 
completely contained on one card. 
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SYNTAX AND SEMANTICS 

Presented here is the format of the various directives and the meaning associated with the symbols. The 
syntax as illustrated in the examples must be followed. 

Any directive having parameters must be terminated by a right parenthesis. If the directive has no parame- 
ters, it must be terminated by a period. 

Whenever a violation of syntax is encountered, EDITL1B will set the abort flag. After ED1TLIB has 
completed a given task, such as checking all directive formats, it will check the abort flag. When set, 
EDITL1B will abort. EDITLIB will continue to check a directive even if it has located an error in that 
directive. EDITLIB will proceed to the next directive only after it has completed analyzing the current 
directive or after it is unable to determine the syntax of the directive. 



SYMBOLS USED IN SYNTAX 

| | The enclosed items are optional. 

or 

The enclosed item is the actual symbol 

name of a routine 

Logical file name 

positive or negative integer 

library name 

residence: 

CM 



1 

( ) 

P 
I In 

n 

pn 

r 



DS 

F.CS 

EM 

Default 



Central Memory 

Disk 

Extended core storage; if no ECS available, then default to disk. 

Extended Core storage: if no ECS available, then Central 
Memory. 

Disk 



8-4 



60306500 A 



Interval in a directive will be interpreted to mean 



P l + P 2 or 



P l- P 2 or 

Pl/P2/ p 3 or 
Pl 

where Pj; are single program names. P1/P2/P3 is va ^ on ^ ^ or ^DD an( * REPLACE directives. It is acceptable 
to replace either Pj or P2 with p] , but not both. EDITLIB will ignore a directive for the following conditions: 

Unable to locate Pi 

Unable to locate P2 

Unable to locate P, when P7 = [*] 

Unable to locate P2 when Pi = [*] 

Unable to locate Pi when there is no interval. 

* This may be used to replace p in the syntax. When * is encountered, EDITLIB will consider all remaining 
routines on the file proceeding from the current position. If the file is a library, the current position is 
the first entry in the PNT. 

+ This symbol is used to designate an inclusive interval. 

Example: Given the ordered set of records A, B, C, D, E, F, and G on a 

file; then A + G represents all members of the file. 

— This symbol is used to designate an exclusive interval. 

Example: Given the ordered set of records A, B, C, D, E, F, G, H, I, and J 

on a file; then D-H represents all members of the file except D, 
E, F, G, and H. This leaves A, B, C, I, and J. 

/ This symbol is used to delimit routine names. 
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Notes 

1. EDITLIB will assign a number to each directive it processes. 

2. EDITLIB will list each input card it receives on the file designated for listable output by the L 
parameter on the EDITLIB statement. The directive as interpreted by EDITLIB will appear directly 
below the input card. The interpreted directive will be prefaced by the number assigned to this directive. 
All comments about the directive will follow the interpreted directive. Since EDITLIB is a two-pass 
program, the results between an EDITLIB run and a LIBEDT run will vary. LIBEDT may stop if it 
finds an error in a directive it is executing; EDITLIB interprets and checks all directives during the first 
pass; it then proceeds to completion unless a fatal error is encountered. EDITLIB may stop then, however, 
in the second pass. Error messages will be generated by referencing the number that is assigned to each 
directive. Error messages will be issued whenever EDITLIB finds it cannot comply with the user's 
request. EDITLIB will also issue messages when it is unable to determine what the user is trying to 
accomplish. 

3. The directives ADD and REPLACE will produce a CONTENT directive on the routines involved. 

4. Any interval specified in a directive will be interpreted to mean: 

In a reference to a file which is a library, the interval will be formed by the entries in the order they 
appear in the Program Name Table. The interval begins when PI is encountered and ends when either 
P2 or the last entry in the PNT is encountered. The table is not handled circularly. 

In a reference to a file that is not a library, the interval will be formed by the order of the routines on 
the file. To find PI, EDITLIB searches from current file position to end-of-file, then rewinds and 
searches the file from the beginning if necessary. The interval ends at whichever occurs first, P2 or 
end-of-file. The file is handled circularly only when searching for PI. 

5. In a System EDITLIB, all directives that do not specifically name a particular library and are not 
contained between a LIBRARY and FINISH directive will refer to the PP library. This means that the 
PP library is the default library when no library is specified. In a user EDITLIB, no PP programs are 
allowed. 

6. EDITLIB will not support TEXT, SEGLOAD records and/or DATA input (7000 LIBEDT). If TEXT/ 
SEGLOAD record/DATA input is found, a message will be issued and the unrecognized records within 
the interval will be ignored. 

7. Miscellaneous 7000 LIBEDT directives: TYPE, ERROR, PCOPY, PMOVE, MOVEC, COPYC, and 
DELETEC. CDC CYBER EDITLIB will ignore these and print a warning message on each directive. 
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SYSTEM EDITLIB 

EDITLIB FILES 

EDITLIB will use ihe following Ifn: 



Ifn 


Cataloged 


ZZZZZOI 


yes 


Z7ZZZ02 


yes 


ZZZZZ03 


yes 


ZZZZZ04 


yes 


ZZZZZ05 


no 


ZZZZZ06 


no 


ZZZZZ07 


no 


ZZZZZ08 


no 


ZZZZZIO 


no 


ZZZZZII 


no 


ZZZZZI2 


no 


ZZZZZI3 


no 


ZZZZZI4 


no 


ZZZZZ15 


no 


ZZZZZI6 


no 


ZZZZZ23 


yes 



Use 

RESET 

RESTORE 

SYSTEM EXTEND 

SYSTEM 

Interpreted directives 

ECS resident routines library file (special case system file) 

Entry Point Name Table spill file 

Program Number Table spill file 

Program Name Table spill file 

External Reference Table spill file 

External Reference Collection spill file 

Library or Deadstart program collection 

Scratch 

PP Program Name Table spill file 

Library Name Table spill file 

Current Directory File 
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System EDITLIB will produce the following type of files: 



File Use 


Ifn 


pfn 


RESET 2ZZZZ01 


ZZZZZ01 


RESTORE 


ZZZZZ02 


ZZZZZ02 


System Extension 


ZZZZZ03 


ZZZZZ03 


SYSTEM 


ZZZZZ04 


ZZZZZ04 


ECS Library 


ZZZZZ06 




Current Directory 


ZZZZZ23 


ZZZZZ23 



The files will be cataloged using the following keys: 



File Use 


ID 


RP 


TK 


CN 


MD 


EX 


RESET 


SYSTEM 


999 


SSSSSSSSS 


XNOX 


XNOX 




RESTORE 


SYSTEM 


999 


SSSSSSSST 








System Extension 


SYSTEM 


QQQ 

999 


SSSSSSSSU 


XNOX 


XNOX 




SYSTEM 


SYSTEM 


999 


SSSSSSSSV 


XNOX 


XNOX 


XNOX 


Current Directory 


SYSTEM 


999 


DIRECTORY 


XNOX 


XNOX 





In SCOPE 3.4, the allocation of ECS is controlled by Monitor. Since the allocation of ECS involves the 
creation of tables and pointers by Monitor, the Deadstart Loader will not duplicate this effort to set up ECS 
files. Due to this change, a new procedure will be required to place routines into ECS at initial deadstart 
time. 

Another task that EDITLIB performs in conjunction with deadstart is that of recovery. Deadstart will call 
EDITLIB to accomplish a C type recovery. In this situation, no operator intervention is required. The 
Deadstart Loader will set bit S.SYSEDT in byte C.DSFLAG in word P.LIB. This bit when set informs MDI 
that it can go ahead and change the directory without issuing the GO/DROP message. When MDI has 
moved the directory from the CP to CMR, it will clear S.SYSEDT and set bit S.EDTRUN in the same byte. 
S.EDTRUN will be set by EDITLIB whenever the directory is changed. 

EDITLIB will also maintain a permanent file (ZZZZZ23) for the Deadstart Loader. This file will contain 
the current system directory as it appears in CMR. 
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The files Z/777.01. /Z7/703. 7777.704. ZZZZZOh. and 7777723 will be cataloged such (hat by attach- 
ing them. CN (Control) and MD (Modify) permission are not granted. That is, the above permission will 
be granted if tin- coiiect passwords arc specified, but not by just specifying the ID (Identification) and TK 
(Turnkey). EDITLIB will request the CN or MD options on Hie ZZZZZ23. When EDITLIB modifies the 
running system, it will do so by adding the new routines to the end of the file called Z7.7ZZ03. By using 
this method. EDITLIB will not keep others from accessing the files. 

SPECIAL HANDLING OF LOCAL FILE NAME SYSTEM 

In SCOPE 3.4, the system file has a Ifn of ZZZZZ04. In an effort to allow the use of the local file name 
SYSTEM and to clarify the handling of the libraries on a system-type file, the user must understand that 
the use of the Ifn SYSTEM is dependent upon the context in which it is used. 

If the Ifn SYSTEM does not appear between the directives READY and COMPLETE, it is treated as a local 
file whose name just happens to be SYSTEM. 

When the Ifn SYSTEM does occur between a READY and COMPLETE directive, the CONTENT directive will 
treat it as a local file name; also ADD and REPLACE will treat it as a Ifn whenever the LIB parameter is 
absent from the optional parameter list on those directives. 

Examples: ADD(IntervaI,SYSTEM,AL=l) 

Add the interval from the local file named SYSTEM. 

ADEKIntervaLSYSTEM.LIB) 

Add the interval from the running system file (ZZZZZ04 or ZZZZZ03), specifically 
the PP library. 

ADD(IntervaI,SYSTEM ) LIB»NUCLEUS ) FL=l) 

Add the interval from the running system file (ZZZZZ04 or ZZZZZ03), specifically 
the CP library called NUCLEUS. 

CONTROL CARDS 

PROGRAM CALL CARD 

EDITLIB(SYSTEM,t l ,t I , . . Q 

where tj can be 

RESET L=lfn 

RESTORE MSGL=n 

l=lfn ERROR»n 

SYSTEM This parameter is a password. It is used by EDITLIB to determine what kind of 

EDITLIB run is to be performed. This key is a program parameter. The key can not 
exceed nine characters and will allow restricted access to the running system directory. 
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RESET 



RESTORE 



I=lfn 



L=lfn 



This parameter instructs EDITLIB to replace the current system directory with the 
directory as it appeared after initial deadstart. Whenever the RESET parameter is 
encountered, EDITLIB will use the directory from the RESET permanent file to re- 
place the directory presently in CMR. It will then change this directory as prescribed 
by the directives in the input file. EDITLIB will then replace the current directory 
with the directory it just modified. A copy of the current directory will be saved on 
the RESTORE permanent file before the change takes place. 

This parameter informs EDITLIB that a user wishes to replace the current system 
directory with the directory as it appeared before the last EDITLIB took place. When- 
ever the RESTORE parameter is encountered, EDITLIB will use the directory on the 
RESTORE permanent file to replace the directory presently in CMR. The rest of the 
procedure EDITLIB follows is the same as for an EDITLIB (SYSTEM, RESET) except, 
that the current directory will not be saved on the RESTORE file. 

This symbol is used to designate the file containing EDITLIB directives. If it is not present, 
the Ifn that will be used is INPUT. If INPUT is used, any binary input to EDITLIB on this 
file must be in the order that it will be requested. This file will not be searched. I appearing 
alone is equivalent to writing I=INPUT. 

This symbol is used to designate the file of listable output from EDITLIB. If it is not 
present, the Ifn that will be used is OUTPUT. L appearing alone is equivalent to writing 
L=OUTPUT. 



MSGL=n 



where n ■ to 8. The default value is 0. This parameter determines the type of list or 
dayfile output generated during execution. 



n 


DIRECTIVE INTERPRETATION 


DIRECTIVE EXECUTION 


MESSAGE TO 
DAYFILE 


LIST INPUT 
CARD 


LIST PREFIX 
TABLE 


LIST OPTIONAL 
PARAMETERS 





NO 


YES 


YES 


YES 


1 


YES 


YES 


YES 


YES 


2 


NO 


NO 


NO 


YES 


3 


YES 


NO 


NO 


YES 


4 


NO 


YES 


YES 


NO 


5 


YES 


YES 


YES 


NO 


6 


NO 


NO 


NO 


NO 


7 


YES 


NO 


NO 


NO 


8 


No Listing Produced 


No Listing Produced 
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ERROR=n where n = to 8. This parameter determines when an abort will occur. Each type of error 

has been assigned a degree of severity which will be checked against the error flag set by 
the ERROR parameter. This check will be performed only when the COMPLETE directive 
is encountered when in System Mode. 



n 


Fatal 


Critical 


Serious 


Minor 


Warning 





YES 


NO 


NO 


NO 


NO 


1 


YES 


YES 


YES 


YES 


NO 


2 


YES 


YES 


YES 


NO 


YES 


3 


YES 


YES 


YES 


NO 


NO 


4 


YES 


YES 


NO 


YES 


YES 


5 


YES 


YES 


NO 


YES 


NO 


6 


YES 


YES 


NO 


NO 


YES 


7 


YES 


YES 


NO 


NO 


NO 


8 


YES 


NO 


YES 


YES 


YES 


bit 

.. ._ 




3 


2 


1 






When no ERROR=n specification is given, any error or warning will cause job termination. 
See the end of this chapter for a list of all EDITLIB errors. 



Examples: 



EDITLIB(SYSTEM) 

ED1TL1B(SYSTEM.RESET) 

EDiTLIBfSYSTEM, MSGL*1 .RESTORE) 

ED!TLIB(SYSTEM,I=INFILE,MSGL-0) 

EDiTLIBfSYSTEM, I*INFILE,LK)UTFILE) 

EDITLIB(SYSTEM,I,L) 

EDITLIB(SYSTEM,MSGL=7,I,L=INFILE^ 
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DIRECTIVE PARAMETERS 

OPTIONAL DIRECTIVE PARAMETERS 

Optional parameters are not positionally dependent. 

AL- 1 where I = to 7777B. Default => 0. AL stands for access level and is a parameter of 

the ADD and REPLACE directives. 1 1 of the 12 bits are meaningful to INTERCOM 
only. The right most bit of this field is used by the system to regulate access to pro- 
gram through control card requests. When this bit is set to 0. the routine or entry 
cannot be called from a control card. The setting of this 12-bit field is determined by 
the binary representation of the octal digits specified by AL. INTERCOM has divided 
the 12-bit field into 3 sections. The first section is one bit in size and is the right most 
bit of the field. The remaining 1 1 bits are divided into two sections according to the 
installation parameter. IP.ACES. IP.ACES = n defines the number of bits to be re- 
served for the access level. The remaining bits (1 1-n) will be used as permission bits. 
When a user requests the use of a command, his access level is checked to determine 
whether it is greater than or equal to the access level of the command. 

If it is. the permission bits of the user are compared against the permission bit of the 
command. If a match is found, the user is given access to the command. If either test 
fails, permission is not granted. 

FL*k where k * 0-377777. Default « 0. FL is a parameter of the ADD and REPLACE directives 

and stands for Field Length. It is meaningful for CM programs only. SCOPE uses the value 
in allocating memory when the program is called. This field length must taken into account 
the CM needed by the loader and all programs, overlays and segments that could be loaded 
by the specified program. 

FLO=m where m = or I. Default = 0. This parameter can only appear on an ADD or REPLACE 

directive. It sets or clears the field length override bit, which determines the execution 
field length. If set, the user's field length may override the FL value set in the library. 

In allocating memory for the execution of a library resident program, SCOPE must deter- 
mine which of the following execution field lengths is to be used: 

Field length (PFL) as specified by the FL parameter; or nominal field length (NFL) 
which can be the last RFL request, or tire FL specified on the job card, or the 
default value IP.SFL. However, the field length allocated cannot exceed the job card 
field length. In determining which field length to allocate, SCOPE uses the FLO flag 
and the automatic field length flag (Reduce bit). The conditions and results are as 
follows: 

When PFL is zero, use NFL 

When PFL is not zero and FLO is zero, use PFl. 

When PFL is not zero and FLO is one and reduce bit is off, use the NFL 

When PFL is not zero and FLO is one and reduce bit is on. use the PFL 

Since the maximum field length that will be allocated is NFL, any job that does not have a 
sufficient field length in which to be loaded for execution will be terminated abnormally. 
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LIB=pn where pn is the name of a library. This is a parameter which can only appear on an ADD or 

REPLACE directive. It is used when the lfn specified in the directive is SYSTEM (meaning 
the running system) or a deadstart file. This parameter specifies what library on the dead- 
start file will be used to satisfy the directive. 

NEWf Mandatory parameter for the LIBRARY directive and optional parameter for the READY 

directive. When a deadstart file is being created, the lfn specified will contain a new library 
or directory. 

OLDf Mandatory parameter for the LIBRARY directive and optional parameter for the READY 

directive. It is required in these directives when an existing library or an existing deadstart 
file is referenced by the lfn parameters. 

r Represents residency as follows: 

CM Central Memory 

ECS Extended Core Storage; if no ECS available, then default to disk. 

DS Disk (default) 

EM Extended Core Storage; if no ECS available, then Central 

Memory. 



t Either NEW or OLD is mandatory, not both. 
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DIRECTIVE RESTRICTIONS 

The following table indicates where directives must occur relative to LIBRARY-FINISH and READY- 
COMPLETE sequences. Any violations of these restrictions will be diagnosed by EDITLIB before any 
directives are executed and will cause an abort accompanied by diagnostic error messages. (See SCOPE 3.4 
Diagnostic Handbook.) 



Directive Restriction 

ADD inside LIBRARY-FINISH or inside READY-COMPLETE 

CHANGE inside READY-COMPLETE 

COMPLETE outside LIBRARY-FINISH and after READY 

CONTENT none 

DELETE inside LIBRARY-FINISH or inside READY-COMPLETE 

ENDRUN outside LIBRARY-FINISH and outside READY-COMPLETE 

FINISH after LIBRARY 

INCLUDE inside READY-COMPLETE 

INCLUDEP inside READY-COMPLETE 

LIBRARY not inside LIBRARY-FINISH 

LISTLIB outside LIBRARY-FINISH 

LISTLNT inside READY-COMPLETE 

MOVE inside READY-COMPLETE 

RANTOSEQ outside LIBRARY-FINISH and outside READY-COMPLETE 

READY not inside READY-COMPLETE 

REMOVE outside LIBRARY-FINISH and inside READY-COMPLETE 

REPLACE inside LIBRARY-FINISH or inside READY-COMPLETE 

REWIND none 

SEQTORAN outside LIBRARY-FINISH and outside READY-COMPLETE 

SETAL inside LIBRARY-FINISH or inside READY-COMPLETE 

SETFL inside LIBRARY-FINISH or inside READY-COMPLETE 

SETFLO inside LIBRARY-FINISH or inside READY-COMPLETE 

SKIPF none 

SKIPB none 

TRANSFER inside READY-COMPLETE 
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DIRECTIVES 

ADD(Interval,lfn[.r)|.cAL = )l][.(FL-)k]|.(LIB=)pn][.(FLO»)m]) 

This directive adds the specified program(s) from the Ifn to the library under construction or modification. 
If the Ifn contains a library, the Program Name Table of the library will be searched to locate the specified 
program(s) to be added. If the file is not a library, the search for the specified program(s) will begin at the 
current record position on the file and proceed to EOF. If the program(s) are not found, the file will be 
rewound and the search will continue until all programs have been searched. If the program(s) are not 
found in the library or on the file, an error message will be issued. If the program(s) to be added already 
exist(s) in the library, an error message will be issued. It is not the function of an ADD directive to replace 
the current program with the new program. This function is accomplished by a REPLACE directive. 

Example: ADD(HIGH,LOW,ECS,AL = 70,FL= 1000) 

ADD(HIGH,LOW,FLO=l) 

ADD(HIGH,SYSTEM,LIB=SCOPE,ECS.AL=- 123) 

CHANGE(pnl,r}) 

This directive is used to change the residence of the library tables in the LNT. If the library already has the 
specified residency or if the library is not part of the system, EDITLIB will issue an appropriate comment. 

Example: CHANGE(FNT,CM) 

COMPLETE. 

This directive informs EDITLIB that the directive list for the directory whose name appeared in the 
READY directive has been exhausted. Simply, it means that there are no more modifications or additions 
to be performed on the directory. This directive must have been preceded by a READY directive. 

CONTENT(Interval,lfn) 

The CONTENT directive is used to obtain information about a program or series of programs on a specified 
file (Ifn)- The information is obtained from the program expanded Prefix Table and the program itself. The 
CONTENT directive applies to all files other than a deadstart file or a LIBRARY file. If information is desired 
on PP programs, the SYSTEM parameter must be entered on the EDITLIB call card. In a multi-file situation, 
CONTENT must be specified for each file. 

Example: CONTENT(ONE,FILEl) 

DELETE(Interval) 

This removes all entries from the library tables that refer to the specified programs. 

Example: DELETE(FEAR) 

DELETE( FEAR + HATE) 
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ENDRUN. 

This directive indicates that execution of directives should stop. All directives following ENDRUN will be 
checked, but not processed. This is an optional directive; if it is not found, one will be generated. If this 
directive is found and EDITLIB finds an error in a directive after the ENDRUN card, it will be llagged but 
will not stop EDITLIB from executing directives which precede ENDRUN. 

FINISH. 

This directive designates the end of the list of directives that will affect the library defined by the last 
LIBRARY directive. Each LIBRARY directive must have a FINISH directive. It is permitted to have multiple 
(LIBRARY, FINISH) sequences within a single directive sequence. 

INCLUDE(pn,lfn[,rj) 

This directive will add the library which is on the specified file to the directory. This allows a user to make 
his user library a part of the running system.t 

Example: INCLUDE(SMOG,AIR,ECS) 

INCLUDE(SMOKE.LUNGS) 

INCLUDEP(lfn) 

This directive allows an old PP program library to be added to the current directory model. The PP program 
library in the current model must be empty when the directive is encountered. Residency and access levels of 
each entry will be that of the entries in the source PP program library. t 

LIBRARY(pn,(OLD) 1 (NEWX,r)) 

The LIBRARY directive during a system EDITLIB run performs two functions. When it is encountered outside 
of a READY and COMPLETE directive, the action taken is equivalent to a user's EDITLIB. When this is the 
case, the user is in a user's EDITLIB mode and thus (NEW=n) is supported, where n is the size of the PNT 
required by LIBEDT. When it is between a READY and COMPLETE directive, the action is also equivalent 
to that of a user's EDITLIB, but the LIBRARY will be found using the Library Name Table (OLD) or will 
be added to the Library Name Table (NEW). 

Example: LIBRARY(FNT,OLD) 

LIBRARY(RUN,NEW,ECS) 

LIBRARY(COBOL,NEW) 



fWhen creating a new deadstart tape from the running system, programs that were ECS resident will become 
disk resident. 
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LISTLIB(liilorv;il,ltn.[pn|) 

The LISTLIB diicclivc is used to list a library which can he a user's library, ruuninn system, nrw system and/ 
or ileatlslart file. 

Example : LISTL1B(C0PY,SYSTEM,SC0PE) 

When between READY and COMPLETE, the Ifn that the list will be performed on is the running system 
and/or the new system under construction. When this directive appears outside of a READY and COMPLETE, 
only a user's library and a deadstart tape can be listed, pn is meaningful when listing the running system, 
new system or deadstart file. If not present, the PPLIB is assumed. L1STHB cannot be present between a 
LIBRARY and a FINISH directive. LISTLIB must be called for each library on a file. 

These directives will send information about the specified program(s) on the lfn or on the lfn and in the pn 
to the output file. The information will come from the object deck being processed. 

Example: LISTUB(COPY,FILEl,SCOPE) 

LISTLIB(1AJ,SYSTEM) 

L1STLNT. 

The LISTLNT directive must appear between a READY and a COMPLETE directive. It will list the Library 
Name Table of the file referenced on the READY directive. It can be used to list either the old system or 
new system LNTs. It will not list the LNT on an old Deadstart file. There are no parameters. 

MOVE(Interval,r) 

This directive will change the residence of CP and PP programs within a system directory. EDITLIB will move 
PP programs to DS, CM, or ECS. Movement of CP programs depends on the residence of the system library 
of which the CP program is a part. If CM resident, movement is unrestricted; but for DS and ECS resident 
libraries, the new residence can be specified only as DS or ECS (the library directory residence must be at 
least as fast as the new residence). 

Example: MOVE(STOCKS,DS) 

MOVE(BONDS+CASH,CM) 

After a library program is requested to be ECS resident and a GO response is received, the user should request 
LISTLIB to determine if the program truly is resident in ECS. 

RANTOSEQ0fnl,lfn2) 

This directive will place a random user library on a sequential file in library format, lfnl is the source file 
name; lfn2 is the destination file name. All records not referenced by the PNT are lost. 
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READY(lfn[,(OLD) i (NEW)]) 

This is the first directive of any directive list pertaining to the lfn specified. Only those directives between a 
READY and a COMPLETE will affect the lfn. The READY directive is used in conjunction with a system EDITLIB 
run. The READY directive specifies that the operation will be performed on a directory. The lfn is either the 
running system or the name of the file which will contain the new system. If the name SYSTEM appears as the lfn, 
it will mean the running system whether the OLD parameter is specified or not; if OLD is specified, lfn must be 
SYSTEM. Directives following the READY directive can be classified into four major functions: Those that modify 
the Library Name Table; those that modify the PP library; those that modify the system library (they must have 
LIBRARY and FINISH directives to delimit them); those that do not change any part of the system directory. 

Examples: 

Directive Identical to 

READY(FUTURE,NEW) READY(FUTURE) 

READY(SYSTEM,OLD) READY(SYSTEM) 

REMOVE(pn) 

This directive removes the library from the running system. The library's entry in the Library Name Table is 
removed. 

Example: REMOVE(FTN) 

REPLACE(Interval,lfn[,r] [,(AL=)1 ] [,(FL=)k] [,(LIB=)pn] [,FLO=)m] ) 

The REPLACE directive in a system EDITLIB will retain the r, AL, FL, and FLO values of the replaced 
routine if not otherwise specified. 

Example: REPLACE(IBM,CDC,AL=70) 

REPLACE(XDS-RCS,NCR,LIB=NUCLEUS) 

In the first example the previous FL, FLO, and r values are retained. In the second, the previous AL, FL, 
FLO, and r values are retained. 

REWIND(lfn[/lfnj ...) 

The result of this directive will be the positioning of the specified file at the first record on the file. To 
accomplish this, EDITLIB will issue a CIO request to do a REWIND. In system mode, the file name 
SYSTEM refers to the running system. 

SEQTORAN(lfnl,lfn2) 

This directive will place a sequential user library on a random file in library format, lfnl is the source file 
name; lfn2 is the destination file name. 
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SETALCIntervaU) 

where I = to 7777 (octal). This directive permits the user to change the access level of a program already 
in the directory. 

Example: SETAL(IBM+NCR,7770) 

SETAL(CDC,1) 

SETFL(Interval,k) 

where k = to 377777 (octal). This directive permits the user to change the field length required to run the 
specified program already in the directory. 

Example: SETFL(BYTE, 100000) 

SETFL(BIT + WORD, 1 00000 ) 

SETFLO(Interval,k) 

where k = or 1 . This directive permits the user to change the field length override bit of programs already 
in the library. The default value is (override is not permitted). 

Example: SETFLO(BITl 1,0) 

SETFLO(BYTE-WORD, 1 ) 

SKIPF/SKIPB(N,lfn,[F] 1 [P]) 

This is the skip-forward and skip backward directive. The meaning of the parameters is as follows: If N is 
numeric, it represents a number of records to be skipped unless the third parameter is present; then N in- 
dicates a number of files. If N is alphanumeric, then the function is skip-by-name and the direction implied 
by the directive is ignored. The file is searched in the forward direction; if the name N is not found, the 
file is rewound and the search continues in the forward direction. When found, the lfn will be positioned 
before the record of that name (N). If N is not found, original position is maintained. The alphanumeric 
form is applicable to sequential files only. While in system mode, the file name SYSTEM means the running 
system. 

TRANSFER(Intervall n,lfn) 

This directive is used to create deadstart. tapes. It will move records whose prefix table has been removed or is to be 
removed. A check will be made to determine if the records being moved have a prefix table. Because a program name 
can be all digits it is necessary to delimit such programs for this directive; e.g. program name is 026, the directive will 
be TRANSFER($026$,SYSTEM). 

Example: TRANSFER(*,SYSTEM) 

TRANSFERS 0,SYSTEM) 
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•/comment 

This symbol is used to denote a comment field; whenever encountered in columns one and two. EDITLIB 
treats it as a comment and will not check the card. 

Example: '/THIS ADDS A PROGRAM THAT WILL DO A/B*C 

LIBRARY DIRECTORY ACCESS 

PP ROUTINES 

When a PP routine wishes to access the library directory, it will first check bit 59 of P.LIB. When bit 59 is 
set to I, EDITLIB is waiting to change or is changing the directory. Thus, the directory is unavailable. 
When bit 59 is set to 0, the directory is available. 

CP ROUTINES 

All CP routines accessing the directory should set bit S.CPLDAF in byte C.CPFLAG in word W.CPFLAG 
of their control point area. To access the directory the following procedure should be followed. First check 
bit 59 in P.LIB; if not set, then set bit S.CPLDAF. Then check bit 59 in P.LIB again. If it is now set, clear 
S.CPLDAF and wait until bit 59 in P.LIB is clear. After access is obtained and directory access is complete, 
clear bit S.CPLDAF. 



EDITLIB 

When EDITLIB wishes to access the directory, it will issue a monitor request to have the PP routine MDI 
assigned to its control point. By passing MDI the appropriate code, MDI will try to change the directory. 
The procedure is as follows: 

MDI will set bit 59 in P.LIB to I to lock out all other routines from initiating a directory access. It 
then checks bit S.CPLDAF in byte C.CPFLAG in word W.CPFLAG in each control point area. If 
the bit is set. it means the job has not completed its last directory access, and MDI will go into the 
event stack until the bit is cleared. After MDI has completed its task, it will adjust the FWA and 
the LWA+ 1 pointers in P.LIB and set bit 59 to 0. 

LIBRARY DIRECTORY POINTER FORMAT 

59 53 35 29 11 



a 


FWA of CM 
Directory 




LWA+1ofCM 
Directory 


Deed Start 
Load Flag 



a «■ Library Change Flag 

P.LIB The use of the first word has been expanded to hold a Library Change Flag (1 bit). 

This flag was added to increase system integrity and efficiency. The Library Change Flag 
tells the PP and any CP program using the directory that an EDITLIB run wishes to 
change the directory or is changing the directory. Only when the flag in the control 
point areas is zero will EDITLIB proceed to change the directory. 
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PP LIBRARY POINTER FORMAT 



59 



47 



35 



23 



17 



CCCG 


0000 


NNNN 


00 


FFFFFF 



P.PPLIB 



FFFFFF is the address of the first entry in the PP Program Name Table. NNNN is 
the number of entries in the PP Program Name Table. CCCC is the position of CIO in 
the PP Program Name Table. This value specifies the number of entries preceding 
CIO. 



MDI will set this word to zero and wait one second before changing the directory. 

FILES 
SYSTEM FILES 

A copy of all the routines referenced by the directory will reside on a permanent file called ZZZZZ04 after 
initial deadstart. If a program or library subsequently is to be included into the directory, it will be placed 
in the permanent file called ZZZZZ03. EDiTLIB will never write, modify or extend the permanent file 
ZZZZZ04. The new version of replaced routines will reside on the file ZZZZZ03. Since EDITLIB will not 
alter any record currently on the file ZZZZZ04 or the file ZZZZZ03, routines may be read from either file 
while EDITLIB is adding new records to ZZZZZ03. 

USER FILES 

The user is responsible for the contents of his library. EDITLIB will not overwrite any record on the file. It 
will only add records at EOF/EOI. This means that the user will have unused records on his file when he 
deletes are replaces programs on his library. It is up to the user to remove this dead space by building a new 
library using the old one as a source. EDITLIB will issue no permanent file request. The user must attach, 
catalog and extend his file. If the library is on tape, the user must build a new library each time an 
EDITLIB is performed on the library, using the old library as a source. 

FILE AND LIBRARY POSITIONING 

EDITLIB rewinds all files except INPUT before executing any directives. After a random library is written, 
it is rewound. When a new sequential library is written, it is left positioned after the end-of-file. New 
directories are rewound when completed. 
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GENERAL 

Index to user's libraries on a random file (six words): 



WORD 

1 

2 
3 
4 
5 
6 



ADDRESS 

Entry Point Name Table 

External Reference Table 

Program Number Table 

Program Name Table 

Entry Point and External Reference List 

Unreferenced PRU Count (not an address) 



Format of user's library on a sequential file: 



RECORD 



2 
3 
4 
5 
6 
7 to EOF 



CONTENTS 

This record is three words long: 

1. ***LIBRARY 

2. Library Name (blank filled) 

3. Date of creation 
Entry Point Name Table 

Entry Point and External Reference List 

External Reference Table 

Program Number Table 

Program Name Table 

Routines 
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SYSTEM SECURITY 

EDITLIB will use the reprieve function to protect the system files and its scratch files. Under any normal or abnor- 
mal termination condition, EDITLIB will have control turned over to a program that will return or release all 
EDITLIB internal files. 

MDI (MOVE SYSTEM DIRECTORY) 

This PP overlay includes the program 6MD which is used to control changes to the CMR directory. If 6MD 
is deleted, the running system may not be changed, but all other functions can be performed. MDI will 
perform the following tasks: 

1. Request field length for directory in CMR. 

2. Set directory change flag. 

3. Get length of directory. 

4. Place CM address into LNT for CM resident libraries. 
5; Copy directory to control point. 

6. Copy directory to CMR. 

7. Check CP activity flags at each control point. 

8. Write current directory file. 

9. Attach FNT to ZZZZZ06 to EDITLIB control point. 

10. Monitor EDITLIB error flag after GO. 

11. Catalog ZZZZZ01 and ZZZZZ02 at control point zero with an ID of SYSTEM. 

A parameter list will be provided in EDITLIB for MDI. This list will contain MDI request code and all 
necessary information. MDI will return information to EDITLIB in this list. This list is the MDI INPUT/ 
OUTPUT register. 

An EDITLIB change to the CMR Library Directory is incompatible with INTERCOM operation. If INTERCOM 
is running, MDI will issue the appropriate message to the operator when any of the following EDITLIB 
directives have been encountered for the reasons noted: 

EDITLIB Directive Reason for Incompatibility 

ADD Library is CM resident. 

DELETE Library is CM resident. 

REPLACE Library is CM resident. 

CHANGE CM is involved in the residency change. 

INCLUDE Unconditionally incompatible. 

LIBRARY Library is new or CM is involved in a residency change. 

MOVE CM is involved in the residency change. 

REMOVE Unconditionally incompatible. 

INCLUDEP Unconditionally incompatible. 
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TABLE FORMATS 



CMR DIRECTORY 



59 



41 



35 



23 



17 



T.LIB 





LWA+1 of LNT 


Library Name Table (LNT) 
(5 Words per Entry) 




LWA+1 of PP 
Program Bodies 




LWA+1 of PPNT 


PP Program Name Table (PPNT) 
(2 Words per Program) 


PP Program Bodies 


CM Resident Libraries 



DIRECTORY/LIBRARY/PROGRAM LIMITS 

The LNT allows a maximum of 27 libraries. A library can contain a maximum of 2047 programs, 2047 
entry points, and 2047 external references. 

A particular program in the library can contain a maximum of 250 entry points and 500 external references. 
The PP program name table allows a maximum of 450 PP programs. 
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CM RESIDENT LIBRARY FORMAT 



59 



47 



35 



17 



11 



Length 
ofPNT 



Length 
ofPNUT 



Length of 
ERT 



Length of 
EPNT 



Library Entry Point Name Table (EPNT) 
(1 Word per Entry Point; 2047 entries maximum) 



Library External Reference Table (ERT) 
(1 Byte per External Reference; 2047 entries maximum, plus 2047 entries in a table extension) 



Library Program Number Table (PNUT) 
(1 Byte per Entry Point; 2047 entries maximum) 



Library Program Name Table (PNT) 
(2 Words per Program; 2047 entries maximum) 



Library Program Bodies 



All information that is a part of the system directory and resides in ECS will be on the 
ECS file called ZZZZZ06. This is a special case system file. 
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Entry Point 
Name Table 

External 
Reference Table 

Program 
Number Table 

Program 
Name Table 

Word I: 
Bit 

Bit 1 



Bit 3 

Bit 15 

Bit 16 

Bit 17 



LIBRARY NAME TABLE ENTRY 




New Library — - 
Modified Library — 
Use Disk Address - 
59 35 18 


ECS Librjry-— n 
EDITEXTEND/ 
SYSTEM Library-. 

14 4 


Library Name 




Address of ECS 
Descriptor 


CM FWA of 
Library 


Disk Address of 
Library 


Address of ECS 
Descriptor 


CM FWA of 
Library 


Disk Address of 
Library 


Address of ECS 
Descriptor 


CM FWA of 
Library 


Disk Address of 
Library 


Address of ECS 
Descriptor 


CM FWA of 
Library 


Disk Address of 
Library 



Library is not CM resident. 

1 Library is CM resident. 

Library is not ECS resident. 

1 Library is ECS resident. 

If bits and 1 are both zero, the directory is on disk. 

Library on file ZZZZZ04 

1 Library on file ZZZZZ03 
Library is new. 

Library is modified. 

Residency addresses are valid. 

1 Use disk address only. 



60306500 B 



8-25 



Bits 15, 16. and 17 are set and cleared by EDITLIB only. They are used when EDITLIB is changing a 
directory that contains many libraries. Any routine that is accessing the library that has these bits set must 
use the disk address to obtain any library table and any routine that is part of this library. These bits are 
necessary due to the dynamic allocation of ECS and the nature of the new directory. 



Bits 18-59 



The library name; can contain up to 7 alphabetic and/or numeric characters of which the first 
must be alphabetic. 



Word 2: 

Address word for the Entry Point Name Table. 

Word 3: 

Address word for the External Reference Table 

Word 4: 

Address word for the Program Number Table. 

Word 5: 

Address word for the Program Name Table. 

Example: 

Bits 



2 


1 




















1 





1 






Library is disk resident. 
Library is CM resident. 
Library is ECS resident. 



Note: Fields not being used contain zero. 
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EPNT ENTRY FORMAT 
59 17 14 



Entry Point Name 



Access 
Level 



Control Card Callable — * 

000 = Relocatable 

001 = Overlay (50 Table) , 

010 - Overlay (51 Table) 

01 1 = Overlay (53 Table) . 

100 = Overlay (54 Table-no ECS) 

101 * Overlay (54 Table-with ECS) 

Bits 0-2 000 The entry point belongs to a relocatable program 

001 The entry point belongs to an absolute overlay which begins with a 50 table. 

010 The entry point belongs to an absolute overlay which begins with a 51 table. 

011 The entry point belongs to an absolute overlay which begins with a 53 table. 

100 The entry point belongs to an absolute overlay which begins with a 54 table and 
has no ECS image. 

101 The entry point belongs to an absolute overlay which begins with a 54 table and 
has an ECS image. 

Bit 3 This entry point cannot be called from a control card. 

1 This entry point can be called from a control card. 

Bits 4-14 These are the Access Level bits for INTERCOM. 

Bits 18-59 Entry Point Name/Entry Point Number value is equal to its position in the table relative to 

the start of the table. The table is sorted alphanumerically. 
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PP PROGRAM NAME TABLE ENTRY 



59 


»1 


38 


35 


EDITEXTEND/SYSTEM Record ■ 

ECS Resident — j 

CM Resident 1 

Control Card Callable — i 

23 17 14 4 


PP Program 
Name 





Length in 
CM Words 





Access 
Level 


ECS Address 


CM Address"'' 


Short Disk Address 
if in CM or ECS 








Long Disk Address if not in CM or ECS 



Word 1 

Bit 

Bit I 
Bit 2 
Bit 3 



If the record is on (pfn) ZZZZZ04 

1 If the record is on (pfn) ZZZZZ03. 

Record/routine is not ECS resident. 

1 Record/routine is ECS resident. 

Record/routine is not CM resident. 

1 Record/routine is CM resident. 

This program cannot be called from a control card. 

1 This program can be called from a control card. 
Bits 4-14 Access Level bits for INTERCOM. 

Word 2 

If the routine is disk resident, there will be a special disk address in bits 0-35 for use by PP resident. 

If the routine is central memory or ECS resident, bits 17-0 contain the short disk address which is the PRU 
offset from the start of the chain. The central memory address is absolute. 

Fields not being used contain zero. 



For ECS resident overlay, this field contains the last consecutive access failure count. The residence is moved 
to RMS when the failure count exceeds an established threshold. 
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ERT ENTRY FORMAT 



59 



47 



35 



23 



11 



Entry Point 
Number + 1 



Entry Point 
Number + 1 



Entry Point 
Number + 1 



Entry Point 
Number + 1 



Entry Point 
Number + 1 or 
Continuation 



The first entry of this table is associated with the first entry in the Entry Point Name Table. The chain of 
Externa! References is terminated by 12 bits of zero or by the 5 th parcel not having bit 1 1 set to 1 . If bit 1 1 
is set to 1, the value contained in this parcel, less bit II, is the relative address of the continuation word. 
The address is relative to the FWA of the External Reference Table plus the Entry Point Name Table. All 
external calls made directly by a routine will be shown in this table. 



59 



47 



PNUT ENTRY FORMAT 
35 23 



11 



Parcel 

Relative 
PNT Address 


Parcel 1 

Relative 
PNT Address 


Parcel 2 


Parcel 3 


Parcel 4 


Parcel 5 


Parcel 6 






Parcel n 



This table holds pointers relative to the Program Name Table for each Entry Point Number. The Entry 
Point Number is the parcel number in this table. There are 5 parcels per word, stored from left to right in 
the sequential bytes of a word. The value in each parcel is the relative address of the programs's entry in 
the Program Name Table. Address is relative to the start of the Program Name Table. 
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PNT ENTRY FORMAT 



Word 1: 
Bits 0-10 

Bit 11 



59 


00 = Disk Address ) 

01 = CM Address [ - 
10 = ECS Address I 

35 17 15 


-— 1 = Program on 
EDITEXTEND 

r~ PL Override Alio 
10 ( 


Program Name 




FL Required 
Divided by 100 * 


ECS or CM Address 


Length of 
Binary Program 




Disk Address 



Bit 12 



Bits 13-14 



Bits 18-59 



Contain the amount of field length divided by 100(octal) to execute this program. If not 
specified during an RDITLIB run, it will be set to DFAULTFL/lOOloctal) where 
DFAULTFI. is a program parameter. 

INTERCOM field length override bit: 

do not override 

1 may be overridden 

1 Program is on (pin) ZZZZZ03. 

Program is on (pin) ZZZZZ04. 

00 Disk address 

01 CM address 
10 ECS address 

Program Name in display code. 



The CM address is relative to the LWA+ 1 of this table. Fields not being used contain zero. 
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ENTRY POINT AND EXTERNAL REFERENCE LIST FORMAT 



59 




17 


C 




Program Number 


Entry Point 




Word of Zeros 


External Reference 




Word of Zeros 



The Entry Point and External Reference List has an entry for each program that is a part of the library. 
This list will be maintained by EDITLIB. The entry point and external references for each routine will be 
in alphabetical order and will be left justified with zero fill. 

The index to this record, when the library is not part of the running system, will be in the index record for 
the random file. When the library becomes part of the running system, the index to the Entry Point and 
External Reference List for the library is destroyed. The Entry Point and External Reference List will be 
placed following the Entry Point Name Table record. By using the index to the Entry Point Table it will be 
possible to access the External Reference List. A CIO Read Skip request will be used with the index to the 
Entry Point Name Table. Then a read with a zero index will be used to obtain the Entry Point and External 
Reference List. 
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LIBRARY TABLE INTERFACES 



LNT ENTRY 



CMR DIRECTORY 



LWA+1 
LNT 



LNT 



LWA+1 
Of PP Prog. 



LWA+1 of 
PPNT 



PP Prog. Name Table (PPNT) 



PP Program Bodies 



CM Resident Libraries 



Library Name 








Address 
of ECS Des. 


CM FWA of 
Library 


Disk Address of 
Library 


■I 


ii 


ii 


" 


M 


it 


II 


M 


M 



EPNT 

ERT 

PNUT 

PNT 



CM RESIDENT LIBRARY 



PP PROGRAM NAME TABLE ENTRY 



PP Pro. Name 





Length 


AL 




ECS Add. 


CM Add. 


Disk Add. 



Length 
of PNT 



Length 
of PNUT 



Length 
of ERT 



Length 
of EPNT 



Library EPNT (2047) 



Library ERT (2047) 



Library PNUT (2047) 



Library PNT (2047) 



Library Program Bodies 



ENTRY POINT NAME TABLE 



Entry Point Name 



T 



AL 



EXTERNAL REFERENCE TABLE 



E.P. 
No.+I 



E.P. 
No.+1 



E.P. 
or Cont. 



.-J 



PROGRAM NUMBER TABLE f 



Parcel 



Parcel 1 



Parcel 2 



Parcel 5 Parcel 6 Parcel 7 Parcel 8 Parceln 



Parcel 3 



r 



T 

J 



Parcel 4 



PROGRAM NAME TABLE 






Pgm. Name 




FL/100g 




ECS or CM Add. 


Length 


Disk Add. 
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EXAMPLES 

Deadstart Creation 

READY(NEWSYS.NKW) 

TRANSFER 1 7,SYSrEM> 

TRANSFER(CMR.NEWCMR) 

SKJPF( I, SYSTEM) 

TRANSFF.RC .SYSTEM) 

LIBRARY(NUCLEUS.NEW) 

ADD(*.SYSTEM.LIB = NUCLEUS.AL = I ) 

REPLACE(EDITLIB.LGO.AL - 1 .FL - 40000) 

REPLACE) LOADER,LGO,AL - 1 ,FL - 20000) 

FINISH. 

LIBRARY(FORTRAN.NEW) 

ADD(*,NEWFTN,AL-0.FL-45000) 

FINISH. 

LISTLIB(*,NEWSYS,NUCLEUS) 

LISTLIB(*,NEWSYS.FORTRAN) 

ADD(*,SYSTEM,LIB) 

REPLACE( 1 SP.LGO.AL - O.CM ) 

LISTLIB(*.SYSTEM) 

COMPLETE. 

LISTLIB(*.SYSTEM.NUCLEUS) 

LISTLIB( \SYS TEM.FORTRAN) 

ENDRUN. 



Deadstart Creation From The Running System 

READY(NEWSYS). 

REWIND(NEWSYS/SYSTEM). 

TRANSFER(*,SYSTEM). 

INCLUDEP(SYSTEM). 

INCLUDE(NUCLEUS,SYSTEM,CM). 

INCLUDE(SYSOVL3YSTEM,CM). 

INCLUDE(SYSIO,SYSTEM). 

. INCLUDE directive for all other libraries that are to 
. be a part of the new system. 

1NCLUDK(SYSMISC,SYSTEM). 

. Directives that will modify any of the libraries 
. just included into the new system or directives 
. that will create new libraries. 

COMPLETE. 
ENDRUN. 
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System EDITLIB 

RHADY(SYSTEM,OLD) 

ADD(*,NEWPP) 

UBRARY(SCOPE 1 ,NEW) 

ADD( *,SYSTEM,UB-NUCLEUS J)S,AL= 1 ,FL=40000,FLO= 1 ) 

RELPACE(LOADER,NEW,DS,AL= 1,FL=20000) 

FINISH. 

USTUB(*,SYSTEM .NUCLEUS) 

COMPLETE. 

READY(SYSTEM.OLD) 

ADEK1ZZ,LGO,AL=0) 

UBRARY(NUCLEUS,OLD) 

DELETE(HOHUM) 

FINISH. 

COMPLETE 

ENDRUN. 



EDITLIB error messages are explained in the SCOPE 3.4 Diagnostic Handbook. 
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INTERVAL CAN NOT BE SATISFIED - PP PROGRAM LIBRARY IS FULL. PROGRAM MAX. REACHED. 
ADJUST MAXLPPNT IN EDITLIB - INSTALL NEW VER. 

INTERVAL CAN NOT BE SATISFIED - PP PROGRAM LIBRARY IS FULL. TABLE OVERFLOW ERROR 
- EDITLIB REQUIRES MORE FL. 

LIBRARY MUST BE ON A RANDOM FILE IF OLD PARAMETER SPECIFIED. 

ONLY LFN SYSTEM CAN BE MODIFIED. 

TABLE OVERFLOW ERROR - EDITLIB REQUIRES MORE FL. 

TABLE OVERFLOW WHILE PERFORMING A DELETE. ENLARGE BUF3. BUF. SIZE ASSEMBLED INTO 
EDITLIB. INSTALL NEW VERSION. 

XREF LIST OVERFLOW - INCREASE THE SIZE OF BUF5. BUF. SIZE ASSEMBLED INTO EDITLIB. 
INSTALL NEW VERSION. 

xxxxxx LIBRARY CONTAINS THE MAXIMUM NO. OF PROGRAMS. 

xxxxxx LIBRARY IS ALREADY IN THE LIBRARY NAME TABLE. 

xxxxxx LIBRARY NOT ADDED TO LIBRARY NAME TABLE. PROGRAM MAX. REACHED. ADJUST 
MAXLPPNT IN EDITLIB - INSTALL NEW VER. 

xxxxxx LIBRARY NOT ADDED TO LIBRARY NAME TABLE. TABLE OVERFLOW ERROR - EDITLIB 
REQUIRES MORE FL. 



Class - CRITICAL 

BUF3 UNABLE TO HOLD PROGRAM NAME TABLE. ENLARGE BUF3. BUF. SIZE ASSEMBLED INTO 
EDITLIB. INSTALL NEW VERSION. 

CIO IS NOT A MEMBER OF THE PP LIBRARY. 

COMPLETE ENCOUNTERED BEFORE DSD WAS TRANSFERRED. 

INCLUDEP INVALID IF PPNT IS NOT EMPTY. 

PARTIAL EDITLIB PERFORMED - SYSTEM MAY BE INOPERATIVE. 

PP PGM NAME TABLE IS EMPTY. 

PPLIB IS BOTH SOURCE AND DESTINATION LIBRARY. 
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Class - SERIOUS 

BUF3 UNABLE TO HOLD LIBRARY NAME TABLE. ENLARGE BUF3. 

DSD WAS TRANSFERRED BEFORE INTERVAL OR COUNT SATISFIED. 

EOF/EOI ENCOUNTERED BEFORE ALL THE RECORDS WERE TRANSFERRED. 

*** ERROR DUPLICATE ENTRY POINT NAME IN PGM NAME xxxxxx. 
ENTRY POINT NAME(S) 

LOCAL FILE xxxxxx CONTAINS AN INCOMPLETE LIBRARY. 

OBJECT DECK CONTAINS ONLY A PREFIX TABLE. 

PREFIX TABLE MISSING OR RECORD IS NOT AN OBJECT DECK. 

RELOCATABLE PGM NAME xxxxxx DOES NOT HAVE AN ENTRY POINT. 

THE LFN SPECIFIED IS NOT A DEADSTART TAPE. 

UNRECOGNIZABLE TABLE FOLLOWING A PREFIX TABLE. 

USER LIBRARY COULD NOT BE FOUND ON FILE xxxxxx. 

ZERO WORD COUNT IN A LOADER TABLE. 

xxxxxx IS NOT A RANDOM FILE. 

xxxxxx IS NOT A SEQUENTIAL FILE. 

xxxxxx IS NOT IN THE SOURCE LIBRARY - NO PROGRAMS ADDED. 

xxxxxx LIBRARY IS ALREADY IN THE LIBRARY NAME TABLE. 
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Class MINOR 

CP PROGRAMS MAY NOT RESIDE IN THE PP LIBRARY. 

FILE NAME xxxxxx CONTAINS AN INCOMPLETE BINARY RECORD. 

INTERVAL CAN NOT BE SATISFIED - UNABLE TO LOCATE FIRST PGM. 

INTERVAL CAN NOT BE SATISFIED - UNABLE TO LOCATE LAST PGM. 

INTERVAL IMPROPERLY FORMED - xxxxxx PRECEDES xxxxxx. 

LOCAL FILE xxxxxx IS NOT A DS TAPE OR USER LIBRARY. 

PP PROGRAMS NOT IN PPLIB CANNOT BE ACCESSED BY PP RESIDENT. 

PP PROGRAM xxxxxx ALREADY IN PP LIBRARY. 

RESIDENCY PARAMETER - ECS - INVALID DURING DEADSTART CREATION. 

UNABLE TO LOCATE PGM xxxxxx ON LOCAL FILE NAME xxxxxx. 

USER LIB. xxxxxx NOW CONTAINS AN EMPTY PNT. FINISH DIRECTIVE NOT PROCESSED - EDITLIB 
WILL CONTINUE. 

xxxxxx ALREADY IN xxxxxx LIBRARY. 

xxxxxx IS NOT THE NAME OF THE NEXT RECORD ON FILE INPUT. 

xxxxxx UBRARY IS EMPTY. LIBRARY WILL BE REMOVED. 

xxxxxx LIBRARY IS NOT A MEMBER OF THE LIBRARY NAME TABLE. 

xxxxxx LIBRARY IS NOT A MEMBER OF THE LIBRARY NAME TABLE. LIBRARY PARAMETER IS 
NOW NEW. 

xxxxxx LIBRARY IS NOT INCLUDED IN THE xxxxxx FILE. 

xxxxxx RESIDES IN ECS SINCE xxxxxx UBRARY NOT IN CM. 

xxxxxx RESIDES ON DISK SINCE UBRARY xxxxxx NOT IN CM. 

FIRST LIBRARY NOT CM RESIDENT, 1AJ CAN-T ACCESS 
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Class WARNING 

LAST DEADSTART RECORD ALREADY TRANSFERRED. DIRECTIVE IGNORED. 

LISTLIB IS VALID FOR NEWSYS/RUNSYS BETWEEN READY - COMPLETE. 

LNT IS EMPTY. 

TRANSFER DIRECTIVE VALID ONLY IN DEADSTART CREATION MODE. 
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SYSTEM BULLETIN UTILITY 



Under SCOPE 3.4. installation system bulletins can be created and stored for user access. Bulletins are 
created and updated with the system utility BULLUP, and are accessed by the user with the control card 
SYSBULL. BULLUP has the capability to (I) create a system bulletin file if none exists, (2) update an 
existing bulletin file, and (3) reduce the size of an existing bulletin file. When BULLUP creates or updates 
a bulletin file, it also builds an index so that bulletins can be accessed by name. Updating the bulletin file 
consists of adding new bulletins to the file and/or updating the information in an existing bulletin. Reducing the 
size of the bulletin file consists of reading the active information from the bulletin file and writing it to a new 
file. 



SYSTEM BULLETIN FILE (BULLUP CARD) 

The control card for calling BULLUP is as follows: 

BULLUP. 
or 

BULLUP(input.output). 

Default input and output files are INPUT and OUTPUT. Alternate files may be used by specifying the alter- 
nate file names. SYSBULL does not have this capability; output from SYSBULL always goes to the file 
OUTPUT. 

BULLUP DATA CARDS 

BULLUP accepts data in card format. Data cards for BULLUP are as follows: 

Name card first bulletin 

Contents card 



Contents card 

Name card second bulletin 

Contents card 



7/8/9 



60306500 D 9-1 



Name cards huve the following format: 

Column 1 2 3 through 9 36 through 80 

Entry * $ bulname bulletin description 

The bulletin name, bulname, may be 1 to 7 letters and digits, and must begin in column 3. The first blank 
terminates the field. Any Combination of characters is allowed except the reserved names INDEX and ALL. 
Up to 100 names may be specified for the system bulletin file. 

Bulletin description, which may contain up to 45 characters, is generally a brief description of the bulletin. 
The bulletin description, which is listed with the index, is the second line of the bulletin. 

Contents cards are any that do not have * $ in columns 1 and 2. Column 1 is used either for printer car- 
riage control or as a continuation card indicator. If card column 1 is not a comma, it is considered to be a 
printer carriage control character, and card columns 2 thru 80 are to be printed in print line positions 1 
through 79. A card with a comma in column 1 is considered to be a continuation card, and card columns 2 
through 58 are to be printed in print line positions 80 through 136. Multiple continuation cards are allowed. 

PROCESSING DATA CARDS 

The most significant difference between a creation run and an update run is the fact that a bulletin file does 
not exist before a creation run. Data cards for a creation run are processed in the same way as for an update 
run. 

A name card is read and validated. If an error occurs in the name card, succeeding bulletin contents cards 
are skipped up to the next name card; and a diagnostic is printed. If the name card is valid, the bulletin file 
index is searched for a bulname match. If none is found, the name is added to the end of the index, and 
the index is changed to reflect the new bulletin.. If a matching name is found, the index is changed to reflect 
the update to this bulletin. BULLUP then fills a buffer with the name card, contents card, and other infor- 
mation, including the current date and whether the bulletin was created or updated. The buffer is written to 
the end of the bulletin file when it becomes full and when a new name card is encountered. After all data 
cards have been read, the bulTetin file is closed and the bulletin file index is appended to the end of the file. 
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CREATING A SYSTEM BULLETIN FILE 

BULLUP creates a bulletin with the name specified in the bulname position of the name card. An index entry 
for each bulletin is stored in the bulletin file index. Control cards are required to create a system bulletin file: 

jobcard 

REUUEST(Z77ZZIN,*PF) 

BULLUP. 

CATALOG(ZZZZZ«N.SYSTEMBULLETINFIL£.ID-SYSBUL. . . .) 

7/8/9 

Name card 

Contents card 



6/7/8/9 

The permanent fde name and the ID of the system bulletin file may be changed. If changed, the attach 
function in SYSBULL must also be changed. Only the permanent file name and the ID are defined in 
SYSBULL. A turnkey (TK=) and/or a read (RD=) password for the system bulletin file may be added. If so, 
the attach function in SYSBULL also must be changed to specify the addition. Extend, modify, and control 
passwords may be specified if desired, without any changes. 

UPDATING A SYSTEM BULLETIN FILE 

BULLUP updates .1 bulletin file by adding new bulletins and/or by updating information in existing bulletins. 
When a new bulletin is added to the file, a new index entry is added to the file index. When the information 
in an existing bulletin is updated, the file index is changed to reflect the fact that the bulletin has been 
updated. 

Control cards are required to update a system bulletin file: 

jobcard 

ATTACH(ZZZZZIN.SYSTEMBULLETINFI1.E.ID-SYSBULL, . . J 

BULLUP. 

EXTEND(ZZZZZIN) 

7/8/9 

Name card 

Contents card 



6/7/8/9 



60306500 D 9-3 



Permanent file considerations for an update run are the same as for a creation run. Data card requirements 
are the same for updating an existing bulletin, as for creating a new bulletin. The old contents of the 
bulletin are not carried forward to the updated bulletin and, if desired, must be re-entered via contents cards. 
Information is deleted from an existing bulletin by using a name card and omitting succeeding contents curds. 
Since disk space for this bulletin still exists, even though it contains no information, a single contents card 
stating that the bulletin contains no information is suggested. 

REDUCING A SYSTEM BULLETIN FILE 

An index entry and its associated bulletin become inactive when that bulletin is updated. BULLUP does not 
use re-write in place, since the new information in an updated bulletin may exceed the old information. To 
maintain minimum disk space for the system bulletin file, BULLUP copies the active bulletins and the current 
index to a new file, which may then be cataloged. The following control cards are required to reduce the size 
of the system bulletin file: 

iobcard 

REQUEST(ZZZZZOU,*PFI 

ATTACHtZZZZZIN.SYSTEMBULLETINFILE.ID-SYSBULL. . . .) 

BULLUP. 

CATALOG(ZZZZZOU.SYSTEMBULLETINFILE.ID-SYSBULL. . . .) 

PURGEIZZZZZIN) 

6/7/8/9 

ZZZZZOU is the new bulletin file. It must be requested for permanent file device residence before BULLUP 
is called, and it must be an empty file. ZZZZZIN is the current bulletin file with active and inactive infor- 
mation. Data cards should not be used when the active bulletins and the current index are to be copied to a 
new file. If a system bulletin file backup is desired. PURGE(ZZZZZIN) need not be used. 

SCOPE/INTERCOM CONSIDERATIONS 

Under INTERCOM, a call to SYSBULL is initiated when a user logs in. SYSBULL attempts to find the specific 
bulletin named LOGIN (if SUP was not specified during login procedures) or SUP. If SYSBULL finds the 
appropriate bulletin information is immediately displayed at the terminal. Bulletins named LOGIN and SUP 
are not mandatory on the system bulletin file. If SYSBULL does not find the system bulletin file or the 
specific bulletin LOGIN or SUP, processing simply continues. However, installations with INTERCOM users 
may wish to keep their users informed via these named bulletins, since INTERCOM automatically initiates 
an attempt to find them. 

Under SCOPE 3.4, a call to SYSBULL is initiated automatically when a batch job enters the system. SYSBULL 
attempts to find the specific bulletin named BATCH. If found, the bulletin information is sent to OUTPUT 
immediately, and processing continues. The bulletin named BATCH is not mandatory on the system bulletin 
file. If SYSBULL does not find the system bulletin file or the specific bulletin BATCH, processing simply 
continues. However, installations may wish to keep their users informed via BATCH since SCOPE automati- 
cally attempts to find the BATCH bulletin. 
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INTRODUCTION 

The purpose of segmenting central memory resident (CMR) is to move operating system central processor code 
from central memory to extended core storage (ECS) in systems having ECS. The code is loaded back to cen- 
tral memory and executed as needed. This reduces the amount of central memory required for the operating 
system and releases that central memory to user jobs running at control points. 

Because of CMR segmentation, the system CP code executes in two different configurations depending on ECS 
availability. When ECS is not available, the system CP code is all located in CM. When ECS is available, most 
of the CP code is ECS resident and loaded as needed in overlay areas. The CMR loader, LDCMR, handles the 
segment relocation and the creation of the ECS segment library. LDCMR is called by deadstart and may also 
run as a utility. If P.AREA is changed, LDCMR must be reassembled. 

The default library used by LDCMR is CMRLIB. An alternate library may be specified in T.ENTRY+W.SGLIB. 
This library should contain all CMR segments and routines used by these segments. Two other programs are 
used by LDCMR. Program LDCMR= is loaded by CDC CYBER Loader to reload LDCMR; this program must 
be a relocatable binary. CMRDIR describes the system to be generated and contains the trace and stack buffer 
lengths, as well as segment names needed for a load. CMRDIR also designates areas where the segments are to 
be loaded. 

LDCMR uses direct access ECS by requesting control point zero ECS FL; therefore, the length of the direct 
access area will change if LDCMR is used to add ECS systems. 

LDCMR catalogs a file called ZZZZCMR with ID=SYSTEM, TK=ECSSYSTEM, MD=XNOX, and EX=XNOX. 

ZZZZCMR has two records: the first record contains a local area table followed by a segment table; the 
second record contains all the completed segments. On a 2.B deadstart, LDCMR uses the lowest cycle of 
ZZZZCMR to rebuild an ECS system if the date-time stamp matches the one in T.ENTRY+W.DTIME. 

If the library directory is moved, LDCMR will attach ZZZZZ02 to lockout EDITLIB operations. On completion 
of the move, ZZZZZ23, ZZZZZ01, and ZZZZZ02 are modified to reflect the current directory. 

If S.SYSEDT is set in P.LIB, LDCMR does not need operator permission to add a system to ECS or to boot- 
strap an ECS system. The bit is cleared by a successful bootstrap. 

LDCMR CONTROL CARD 
LDCMR (p,^ Pn ) 

p Each p is a nonpositional parameter as described: 

(Input file parameter) 

F=filename If PO=P is not selected, this file contains CMR segment relocatable binaries and/or 

CMRDIR. When segment binaries needed to build a CMR are not on the named 
file, they are taken from library CMRLIB. If two or more copies of the same 
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segment exist on the named file, the last one encountered is used. If a deck 
called CMR is present in the input, all information needed by LDCMR is taken 
from this CMR. If P.AREA is changed, LDCMR must be reassembled. If PO=P 
is selected, the named file contains the same information as ZZZZCMR (area 
table, segment table, and CMR without the low core tables). 

F Use file LGO. 

F=0 No load. The B, L, LO parameters are ignored. PO options A and T are ignored. 

Absent No input file. 

(System image file parameter) 

B=filename LDCMR writes the system image to the named file. This file can be used later 

to create a new system (see PO options). 

B File CMR is used. 

B=0 or No file is generated. 

Absent 

(List file parameter) 

L=fuename All output goes to the named file. 

L or All output goes to file OUTPUT. 

Absent 

(List options parameter) 

LO=option The letter or letters selected specify the contents of the map. Any of the options 

S, B, E, X, and L can be combined; for example, LDCMR(LO=SBL). The N option 
can be combined only with the L option; for example, LDCMR(LOLN). If none 
of the CDC CYBER Loader map options (N, S, B, E, or X) are selected or an error 
is detected in processing the parameter, the current job default is used. 

Option Map Contents 

S CDC CYBER Loader statistics 

B CDC CYBER Loader block map 

i E CDC CYBER Loader entry point map 

i X CDC CYBER Loader entry point cross references 

L LDCMR map 

i. 

! N No CDC CYBER Loader maps are generated 

LO Equivalent to LO=SBEXL 

Absent I Equivalent to LO=L 
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(Processing options parameter) 

POstring Ea cn character selects an option, order of execution is IPTRDCAB. 

The following characters in the string select the options: 

A Add a new CMR to ECS. If the old system is not running, LDCMR bootstraps 

the old system first. 

B Bootstrap alternate system and move library if necessary. This option requires 

operator permission. 

C Catalog a new cycle of ZZZZCMR with the, lowest cycle. 

D Delete new system from ECS. If the new system is running, LDCMR bootstraps 

the old system before releasing ECS. D is completed before A, so PO=DA has the 
same effect as PO=A. 

I Initialize system. Used only at deadstart time to examine deadstart options and 

perform indicated action. This option overrides all other PO options. 

P Input file specified by F parameter has been pre-processed by LDCMR and is in 

the same format as the ZZZZCMR file. 

R Replace old system in ECS with the new system. If the old system is running, 

LDCMR bootstraps the new system before releasing ECS space taken by the old 
system. The bootstrap moves ECS copy. 

T Trace all GOTOs. Do not change a GOTO to an entry point in CM resident to a 

direct jump. 

PO Options ABC are used. 

Absent No options are used. 
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LDCMR 1 


= ILES 


lfn 


Cataloged 


ZZZZZ03 


No 


ZZZZZ04 


No 


ZZZZZLO 


No 


ZZZZZL1 


No 


ZZZZZL2 


No 


ZZZZZL3 




ZZZZZL4 
ZZZZZL5 


No 


ZZZZZL6 





Use 

Read system library binaries from this file. CMR directory may 
be on this file. 

Same as ZZZZZ03. 

CDC CYBER Loader input file containing CM resident binaries. 

CDC CYBER Loader input file containing the monitor area binaries. 

CDC CYBER Loader input file containing the user area binaries. 

Reserved for CDC. 



ZZZZZL7 



ZZZZZL8 



ZZZZZL9 



No 



No 



No 



File containing LDCMR= and a dummy (0,0) overlay. This forces 
CDC CYBER Loader to load at the correct address and return to 
LDCMR when loading completes. 

CDC CYBER Loader output file where all the loaded segments 
are written. 

LDCMR scratch file used to save its tables while CDC CYBER 
Loader is running. 



ZZZZZ01 


Yes 




Modify reset file in case directory moved. 




ZZZZZ02 


Yes 




Interlock file to lock EDITLIB out. Modify restore file if directory 
is moved. 


ZZZZZ23 


Yes 




Modify directory file if LDCMR has moved T.LIB. 




ZZZZCMR 


Yes 




Save the area table, segment table, and segments on this file so 
that LDCMR does not need to reload them. 


PERMANENT FILE PARAMETERS 










lfn 




ID- 


RP= 


TK« 


CN- MD= 


EX= 


ZZZZZOI 




SYSTEM 


999 


SSSSSSSSS 


XNOX XNOX 


XNOX 


ZZZZZ02 




SYSTEM 


999 


SSSSSSSST 


... 


XNOX 


ZZZZZ23 




SYSTEM 


999 


DIRECTORY 


XNOX XNOX 


--'- - 


ZZZZCMR 




SYSTEM 


999 


ECSSYSTEM 


XNOX 


XNOX 
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SYSTEM SECURITY 

LDCMR uses the reprieve function to protect the system files and its scratch files. Under normal or abnormal 
termination, LDCMR will return or release all LDCMR files. 



LDCMR INTERLOCK 

When LDCMR changes the ECS system, LDC is called to assign the ECS. LDC assigns the block of ECS under 
control point zero in the direct access area. 

LDC uses a bit in the control point area to keep CPMTR from changing the ECS FL and ECS RA. This pre- 
vents the scheduler from changing LDCMR's exchange package while LDCMR is running. This bit is cleared 
when LDCMR has signalled LDC that it has completed the change. The method used to set/clear this bit is 
as follows: 

1 . Set/clear bit in control point area. 

2. Wait before reading the word. 

3. If MTR has changed the word, try again; otherwise, continue. 

This interlock is also used to prevent two LDCMRs from bootstrapping or changing the ECS system at the 
same time. 

LDC 

This PP overlay is used to help LDCMR. It can perform the following tasks: 

1. Read absolute CM. 

2. Assign or release control point ECS from the direct access area. 

3. Catalog permanent files with ID=SYSTEM at control point zero. 

4. Reload LDCMR after CDC CYBER Loader completes loading each stage. 

5. Bootstrap a new or old ECS system. 

6. Move the directory. 

7. Issue all operator GO/DROP messages. 

A parameter list is provided in LDCMR. for LDC. This list contains the LDC function code and all necessary 
information. LDC returns information and sets the completion bit within this list. 

For an explanation of the directory move process, see section 8 on EDITLIB. LDC uses the same procedure. 
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RESERVED NAMES 

LDCMR uses the following names which should not be used by the operating system: 

DUMMYnn 

nn A number from 00B to 77B 

The names DUMMYnn are entry, point names which must not be defined in any segment. 

LDCMR also uses the common block name of CMRES to relocate the load address for each area. At the 
present time, common blocks are not permitted within segments. 

SAMPLE JOBS 

Adding a new system to ECS and booting the new system. The new binaries are on file X. A map will also 
be generated. 

LDCMR (PO=AB,F=X) 
Replace the old system with the new and release the ECS space. 

LDCMR (F=0J»O=R) 
To gel u load map of the deadstart system. 

LDCMR. 

To save the preloaded system for later use. 

REQUEST(x.*PF) 

LDCMR(B=x) 

C ATALOG( x,pfn,ID=user) 

To load and bootstrap a new system from the preloaded file. 

ATTACH(x,pfn,ID=user) 
LDCMR(F=x,PO=PAB) 



104 
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LDCMR ERROR MESSAGES 
NON-FATAL MESSAGES 
BAD ARGUMENT TO LDCMR 
B=filenam IGNORED 

Use of F=0,B=filenam causes LDCMR to issue this message. 
CMR LIBRARY SHOULD BE DISK RESIDENT 
COPYING INPUT TO RANDOM FILE 
DUPLICATE PROGRAM IN INPUT-progname 

There is an extra copy of progname for each occurrence of this message. 

ECS COMPARE ERROR. RA+XO=nnnnnnnn 

WROTE - XXXXXXXXXXXXXXXXXXXX 
READ - YYYYYYYYYYYYYYYYYYYY 

LDCMR will try to load the segment or table at the address nnnnnnnn+1. This may continue until 
LDCMR runs out of ECS. If an ECS parity error occurred, then this will be preceded by a parity error 
message. 

ILLEGAL CHARACTER IN ARGUMENT IS DISCARDED 

LDCMR PERMANENT FILE ERROR 
LFN=lfn nn FC STAT=mm 
PFN^pfn 

The permanent file given by pfn was used with the permanent Hie function of nn and received a status 
of mm. 

LDCMR WAITING FOR pfn 

The permanent Hie pfn is attached to another control point. 
LOCKING ED1TLIB OUT 

LDCMR is attaching ZZZZZ01, ZZZZZ02, and ZZZZZ23. 

MISSING SYSTEM CMR LIBRARY 

LDL was called to find the system library as given by the CMR on input or by the CMR entry 
T.ENTRY+W.SGLIB. 
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MORE THAN SEVEN CHARACTERS - EXCESS IGNORED 

I.IX'MR control card cracker will only handle parameters up to seven characters. 

scgnamo MUST" W IN CM RESIDENT 

The segment given will be moved to the CM resident area because the SEGDEF macro specifies this to 
he a CM resident segment. 

NO FILE TO CATALOG 

LDCMR was called with F=0,PO=C which means there is no ZZZZCMR file to catalog. 
NO SYSTEM TO ADD TO ECS 

LDCMR was called with F=0PO=A which means there is no ZZZZCMR to build an ECS system. 
PARITY ERROR K=nnnnnn XO=xxxxxxxx 

An ECS read parity error occurred with XO=xxxxxxxx and the length of nnnnnn. 
PO=A OPTION IGNORED 

M" a CM ft was on the input file, LDCMR will not add this system to ECS because it may not match 
the running system. 

PURGE A CYCLE OF ZZZZCMR THEN TYPE NOGO 

There are already five cycles of ZZZZCMR. Purge one or drop this job. 

PURGING ALL ZZZZCMR FILES 

A deadstart message issued if LDCMR cannot use a cycle of ZZZZCMR to build a system (2.B deadstart 
with date-time stamps matching). 

REMOVING ED1TLIB LOCKOUT 

Modify and return system files ZZZZZ01, ZZZZZ02, and ZZZZZ23. 
TERMINATOR MISSING 

The LDCMR control card must be terminated by a right parenthesis or period. 
UNDEFINED LOADER MAP OPTION-x 

The letter x is not a valid loader map option. 
USING CMR FROM INPUT FILE 

System entry points and date-time stamp are taken from the CMR on the input file. 
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USING LAST LOADER MAP OPTION SPECIFIED 

Multiple louder map options specified. 
USING SYSTEM LIBRARY xxxxxxx 

Using the alternate system library xxxxxxx for all segments and routines. 
= WITH NO FOLLOWING VALUE - - IGNORED 
ZZZZCMR CATALOGED 

FATAL MESSAGES 

AREA DEFINITION OUT-OF-ORDER IN CMRDIR 

Specify the areas in increasing order. 
BAD CMR ON INPUT FILE 

Pointers in word P.AREA are illegal or the binary is not a complete SO table. 
BAD FILE - xxxxxxx 

File xxxxxxx does not conform to LDCMR specifications. 
CMR IS NOT A LEGAL SEGMENT NAME 

Remove segment CMR from CMRDIR. 
COMMON BLOCKS NOT PERMITTED - xxxxxxx 

Segment xxxxxxx contains a common block which LDCMR cannot handle at this time. 

COULD NOT RECOVER ECS AREA TABLE 

The new ECS system has a parity error in the area table. We cannot move the area table without 
changing the ECS and CM alternate ECS addresses. 

DATE-TIME STAMPS DO NOT MATCH 

The running system has a different date-time stamp than the one just read on the file LDCMR. 
DUPLICATE ENTRY POINT NAME - xxxxxxx 

Entry point xxxxxxx has occurred in a previous segment or is defined in the T.ENTRY table. 
ECS WRITE ABORT 
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ENTRY xxxxxxx 16 IN THE WRONG MODE 

A GOTO or CALL was made to xxxxxxx which is not in the same mode as the calling segment. 
INCREASE LBUK IN LDCMR 
INCREASE l.WSA IN LDCMR 
ILLEGAL FILE NAME -xxxxxxx 
INIT NOT IN SEGMENT TABLE 

Segment INIT is required for the system initialization after a bootstrap. 
INSUFFICIENT FL. (nnnnnn USED) 

LDCMR requires more field length. 

LDCMR CANNOT RUN ON THIS SYSTEM (T.AREA=0) 

The CMR being used has P.AREA with zero pointers for T.ENTRY and T.AREA. LDCMR must find 
the entry points, date-time stamp and alternate library. 

LDCMR SYSTEM ERROR 

Get a dump for a systems analyst to examine. LDCMR has been betrayed by the operating system or 
itself. 

MISSING AREA HEADER IN CMRD1R 

LDCMR is expecting an area header after the lengths of the stack and trace buffers. 
MISSING ENTRY POINT - xxxxxxx 
MISSING PROGRAM - xxxxxxx 
MISSING 34 TABLE IN SEGMENT xxxxxxx 

PIDL table missing from the segment binary. 
MISSING 36 TABLE IN SEGMENT xxxxxxx 

ENTR table missing from segment binary. 
MISSING 40 TABLE IN SEGMENT xxxxxxx 

TEXT table missing from the segment binary. 
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MISSING 50 TABLE IN CMRDIR 

CMRDIR must be an absolute program with thf entry address at the LWA of CMRDIR. 
Pt>l ON INITIAL I.IX'MR 

PO=l is required on first I.DCMR and is illegal on later I.DCMRs. 
POP WITHOUT INPUT FlLF 

If PO*P is selected, the F=filename option must be used, 
SEGMENTS MISSING FROM FILE - xxxxxxx 

File xxxxxxx does not contain all the segments it should. 
TABLE LENGTH ERROR IN CMRDIR 

The lengths of the stack and trace buffers are larger than 10000B, which usually means CMRDIR is bad. 
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SYSTEM DYNAMIC DUMP 



11 



The SCOPE operating system includes software which allows a facility to take an on-line core-image dump 
of PPU and central memory and to list the dump on printed output. 

This facility is currently used by INTERCOM to document the PPU and central memory contents at the time 
that a detected error forces an INTERCOM Restart. 



INTERFACE 

All dumps are written, directly by stack request, to system file ZZZZZDD (the system dynamic dump file). 
ZZZZZDD is initialized and recovered by the operating system. 

ZZZZZDD is cataloged and purged as a queue file with special disposition code 66B. When not in use, the 
file is unlocked at control point zero. During a dynamic dump, the file is locked by the program requesting 
the dump. While it is being listed, the file is attached to a control point. The file is associated with a file 
supplement table in the FNT which includes special link ident 602B. Current RMS position is kept in the 
supplement. 

Peripheral processor memory dumps are written directly from the PPU using macros defined on system text 
SDDTEXT to establish the interface for access to the file. CATALOG, EXTEND, and PURGE of the file 
and CM dumps are performed by PPU service program 1DD. Text SDDTEXT includes macros which provide 
a standard interface to call 1DD. 

DYNAMIC DUMP FILE 

Each memory dump request is written as a separate record on the system dynamic dump file. 

Peripheral processor dumps are unlabeled and are written as single records with end-of-record level zero. 

Each CM dump includes a label followed by a contiguous block of central memory core image terminated by 
a short PRU with end-of-record level 15B. The label and the core-image dump are separate records. The label 
format is: 



59 



Contents of: 



CM(xxxxxx, 







y y y y v y ) 


1 




HH.MM.SS 


2 


T.CLK 


MM.DD.YY 


3 


T.DATE 




4 


T.SLAB2 


System Label. 


5 


T.SLAB3 




6 


T.SLAB4 




7 


T.SLAB5 




10 


T.SLAB6 
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All entries are in display code. Words 0-1 of the label define the CM address bounds of the following dump. 
Words 2-10 are taken from CMR at the time of the dump. 



At the end of the dynamic dump, a trailer label is written in the following format: 
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Contents of 


END OF F 1 L 




E NO nnnnn 


1 




H H . M M . S S 


2 


T.CLK 


MM. D D . Y Y 


3 


T.DATE 




4 


T.SLAB2 


System Label. 


5 


T.SLAB3 




6 


T.SLAB4 




7 


T.SLAB5 




10 


T.SLAB6 



All entries are in display code. Word 1 contains the dump number referenced by LISTCID. Words 2-10 
correspond to the same words in the CM dump label. 

LISTING SYSTEM DYNAMIC DUMP FILES 

LISTCID (list core-image dump) is a control card callable system utility which creates listable output from the 
central site console. LISTCID requests a central site operator GO or DROP to provide security for access to 
absolute system dumps. 

LISTCID will list all, or selected portions, of a core-image dump file, depending on the specified control card 
arguments. 
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Calling Sequence: 

The LISTCID control card has the following format: 

LISTCID (pl,p2,. ..,pn) 

where p may be a keyword or a keyword equated to a value. Keywords, listed below, may be specified in any 
order. 

Keyword Significance 

I Input file designation 

omitted Core-image input is taken from the system dynamic dump file, ZZZZZDD. 

or 
I 

I=lfn core-image input is taken from file lfn. 

Output file designation 

omitted Listable output is placed on file OUTPUT and in the output queue at 

or end-of-job (unless otherwise disposed by the calling job). 



O-lfn Listable output is placed on file lfn. Disposition of lfn must be provided 

by the calling job. 

C List available dumped central memory in byte format.f 

omitted No specific CM dump. 

C List all central memory dumps encountered. 

C=L List central memory from address to address L. 

C=F-L List central memory from address F to address L. 

CD List available dumped central memory in display code format.f 

omitted No specific CM dump. 

CD . List all central memory dumps encountered. 

CD=L List central memory from address to address L. 

CD=F-L List central memory from address F to address L. 



flf no list control arguments (C, CD, or P) are specified, all of the core-image input file will be listed in 
byte format. If any of these arguments are specified, each record on the core-image input file is examined 
and listed according to specified list control arguments. 
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P list available dumped peripheral processors in byte format.f 

F File selector parameter 

Each dynamic dump is concluded with an end-of-file. As multiple files may exist on the 
dynamic dump file, the F parameter is used to select which of the multiple files to read. 
File numbers are assumed decimal unless a radix is specified. 

omitted All files selected, 

or F 

F=F File number F is selected, (first file is number 1) 

F=F-L File numbers F through L are selected. 

All numeric values may be octal or decimal. The character B or D immediately following the number specifies 
octal or decimal. If not specified, all addresses are assumed to be octal. 

When the dump input file is ZZZZZDD, LISTCID issues the following message: 

SYSTEM DUMP LIST REQUESTED/GO OR DROP 

The central site operator must enter j.GO to allow LISTCID to continue. 

Examples: 

To list the contents of the system dynamic dump file from the central site console, the operator must - 
select a clear control point and enter: 

n.X LISTCID. 

When LISTCID requests an operator GO or DROP, the operator must enter: 

n. GO 

To list all peripheral processor dumps and any central memory locations between and lOOOOg, a batch 
job might contain the control card: 

LISTCID (P,CMO-10000) 



I flf no list control arguments (C, CD, or P) are specified, all of the core-image input file will be listed in 
byte format. If any of these arguments are specified, each record on the core-image input file is examined 



and listed according to specified list control arguments. 
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LISTCID issues the following error messages: 

LISTCID ARGUMENT ERROR 
Unrecognized keyword. 

LISTCID NUMERIC CONSTANT ERROR 
A numeric value is ill-formed. 

LISTCID ARGUMENT CANT BE EQUATED 
A P parameter was followed by an = sign. 

LISTCID ARGUMENT FWA .GT. LWA 

CM parameter (C or CD) first address specified is greater than second address. 

LISTCID-TOO MANY PARAMETERS 

Too many parameters were entered on the LISTCID control card. 

LISTCID-ONLY ONE F PARAMETER ALLOWED 

More than one F parameter was entered on the LISTCID control card. 

INCOMPLETE DUMP 

The dynamic dump file contains an incomplete dump. A CM or ECS header specified an address 
range for which the following record on the dynamic dump file did not contain sufficient words. 

DUMP FORMAT ERROR OR EMPTY FILE 

The dynamic dump file was not formatted properly, or it was empty. The dynamic dump file is 
listed up to the point where the error is detected. 
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STANDARD SCOPE CHARACTER SETS 



The character sot selected when the system is installed should be compatible with the printers. 

With an installation parameter, the installation keypunch format standard can be selected as 026 or 029; the 
installation parameter can also allow a user to override the standard; a user may select a keypunch mode for 
Iris input deck by punching 26 or 29 in columns 79 and 80 of his JOB card or any 7/8/9 end-of-record card. 
The mode remains set for the remainder of the job or until it is reset by a different mode selection on 
another 7/3/9 card. 

The physical end of a unit record (card, print line or any other significant character string) is delimited by 12 
zero bits. The use of two colons in succession will produce 12 zero bits interpreted as a unit record termi- 
nator. This general restriction on the use of the colon character applies throughout SCOPE 3 and all of its 
product sets. 
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87 
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12 

8-5 
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COLLATING SEQUENCE 








Collating 








Collating 








Sequence 
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Display 


External 


Sequence 


CDC 
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Graphic 


Code 
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Code 
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00 00 
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55 


20 


32 40 


H 
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< 
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15 
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fin installations using the 63-graphic set, the % graphic does not exist. The : graphic is display code 63, 
External BCD code 16. 
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CON I ftOL OATA CHARACTER SETS 
SHOWING TRANSLATIONS BETWEEN DISPLAY CODE AND ASCII/EBCDIC 



DISPLAY 


ASCII 


i _ 

EBCDIC 




DISPLAY 
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I8COIC 


CODE 


UPPEM LOWER 
CASE CASE 


UPPER. 
CASE 
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CASE 
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NOTES 



1 The lacmi "upper case " ,»ul lower caw" apply unly io the else con. 
versions, .mridp nor ni-cen.it tiy reflect my true "cast". 

J V>*i-.i tr-runno Iruin Oisul.iv C.Hie to ASCII EBCDIC, the "upper 

(•«•*» erjutveient characnv k taken 
.1 When tiatislitti^ lt.. m ASCll'EBCOIC lo ChstiMy Code, the upper 

t.ne" and "ipwt t.ise " rtujtmi foul together lo a (tingle Display 

Cmle equivalent character. 
4 All ASCII and EBCDIC codes not listed are ti.insl.itnl to Onolev Code 

55ISPI 



5. Where two Display Cod* graphics are shown lor a single octal code, 
the leftmost oraph.c corresponds to that COC 64-ehar jcter set (system 
assembled with IP CSET set to C64.ll. and the rightmost graphic cor 
responds to the CDC 64<heracter ASCII subset (system assembled with 
IP CSET sat to C64 21 

6. In a 63 characni set system, the display cod* for the : graphic is 63. 
The % charade does not earn, and translations Irom ASCll'EBCOIC "~ 
or ENO yield blank (56.1. 
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HEXADECIMAL-OCTAL CONVERSION TABLE 



^\ 


First 



Hexade 
1 


cimai 1 

2 


Digit 
3 


4 


5 


6 


7 


8 


9 


A 


B 


C 


O 


E 


F 


Second 

Hexadecimal 

Digit 





000 


020 


040 


060 


100 


120 


140 


160 


200 


220 


240 


260 


300 


320 


340 


360 


1 


001 


021 


041 


061 


101 


121 


141 


161 


201 


221 


241 


261 


301 


321 


341 


361 


2 


002 


022 


042 


062 


102 


122 


142 


162 


202 


222 


242 


262 


302 


322 


342 


362 


3 


003 


023 


043 


063 


103 


123 


143 


163 


203 


223 


243 


263 


303 


323 


343 


363 


4 


004 


024 


044 


064 


104 


124 


144 


164 


204 


224 


244 


264 


304 


324 


344 


364 


5 


005 


025 


045 


065 


105 


125 


145 


165 


205 


225 


245 


265 


305 


325 


345 


365 
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006 


026 


046 


066 


106 


126 


146 


166 


206 


226 


246 


266 


306 


326 


346 


366 


7 


007 


027 


047 


067 


107 


127 


147 


167 


207 


227 


247 


267 


307 


327 


347 


367 


8 


010 


030 


050 


070 


110 


130 


150 


170 


210 


230 


250 


270 


310 


330 


350 


370 


9 


011 


031 


051 


071 


111 


131 


151 


171 


211 


231 


251 


271 


311 


331 


351 


371 


A 


012 


032 


052 


072 


112 


132 


152 


172 


212 


232 


252 


272 


312 


332 


352 


372 


8 


013 


033 


053 


073 


113 


133 


153 


173 


213 


233 


253 


273 


313 


333 


353 


373 


C 


014 


034 


054 


074 


114 


134 


154 


174 


214 


234 


254 


274 


314 


334 


354 


374 


D 


015 


035 


056 


075 


115 


135 


155 


175 


215 


235 


255 
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315 


335 


355 


375 


E 

F 


016 


036 


056 


076 


116 


136 


156 


176 


216 


236 


256 


276 


316 


336 


356 


376 


017 


037 


057 


077 


117 


137 


157 


177 


217 


237 


257 


277 


317 


337 


357 


377 


Octal 


000- 

037 


040- 


100 


137 


140 


177 


200- 

237 


240- 

277 


300- 

337 


340- 

377 
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SCOPE SYMBOL DEFINITION B 



SCOPE Text (SCPTEXT) contains system macros, micros, and symbols used by COMPASS CPU and PPU pro- 
grams mat comprise the SCOPE operating system. SCPTEXT contains me following common decks: 

ACTCOM CPU program system action request macros 

COMAFET File Environment Table generation macros 

COMSRAS System communication (RA) symbols 

CPSYS CPU input/output macros using the Central Program Control (CPC) library routines 

PPSYS PPU program system macros, micros, and symbols. 

SCPTEXT is made up of CPCTEXT and PPTEXT. CPCTEXT may be used when only user-mode CPU programs 
are assembled, and PPTEXT may be used when only PPU programs are assembled. 

Common deck COMSRAS contains definitions of symbols of the form RA.xxx which are addresses of words 
in the communication area (RA+O through RA+100). 

A listing of system symbols can be obtained with the following job deck: 

job card (including a request for MT01 

REQUEST(OLDPL,E,HY) SCOPEPL1 

UPDATE(Q) 

C0MPASS(S=0,I*COMPILE) 

7/8/9 

♦COMPILE PPTEXT 

6/7/8/9 

Refer to the SCOPE 3.4 Reference Manual, section 6, for a list of common decks and text overlays. 
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PPSYS IDENTIFIERS 

Common deck FPSYS contains definitions of symbols of the form: 

iJtin 

i Identifier; one or two alphabetic characters specifying the category to which the symbol belongs. 

C Byte number in CM word (0-4). C identifiers are used for flags and parameters of 

12 bits or less. 

CH Pseudo channel assignments 

D Direct cells 

EX M.ICE or M.SPM parameter values 

F Error flag values 

L Lengths 

LE Length of table entries 

M FPU request of monitor 

N Number 

Stack processor orders 

OV FPU overlays; mnemonic is the overlay name 

P CM location of pointer words 

R FPU resident entry points 

S Number of bits to right shift a parameter to right justify it in a FPU word. Some 

symbols, notably those related to the scheduler, are the number of bits to right shift 
a parameter to right justify it in a CM word. 

SF Subsystem function 

T First word address of CM tables. The system programmer should use the P. definition 

rather than access the table directly with the T. definition 

W Relative positions in CM tables 

mn Mnemonic; one to six alphanumeric symbols suggesting the use of the symbol. For example, 
P.ZERO identifies CMR pointer area word 70B, which contains binary zeros. 
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SECTION 1 
CENTRAL MEMORY RESIDENT TABLES 
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FSTT (DA File) 


II-3-31 


FSTT (AK File) 


II-3-33 


Swap File Format 


II-3-35 


EXTENDED CORE STORAGE TABLES 




Overall ECS Format 


II-4-1 


ECS Label 


II4-1 


ECS Partition Format (within each partition) 


H-4-2 


Inter-Computer Area 


H-4-3 


System Pointer Area 


H4-4 


Flaw Table 


II-4-5 


System Page 


II-4-5 


Segments in an ECS System 
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CENTRAL MEMORY RESIDENT 








Pointers 


100 


T.CST 


Channel Status Table 


154 




PP Status Words 


200 


T.CPA n 


Control Point Areas 




T.XPIDLA 


System Exchange Packages 




T.PPC1 


PP Communication Areas 


* 


T.EST 


Equipment Status Table 


• 


T.FNT 


File Name Table 
CIO-CPCIO Special FNTs 
Permanent File FNTs 


• 


T.ITABL 


INTERCOM Table 


• 


T.DAT 


Device Activity Table 


» 


T.RMSBUF 


RMS Buffer 


• 


T.STG 


Tape Staging Table 


• 


T.APF 


Attached Permanent File Table 


* 


T.RQS 


Request Stack 




T.RST 


Request Scheduling Table (RMS) 




T.RBR 


Record Block Reservation Table (Headers) 




T.RBRBIT 


RBR Bit Table 




T.DST 


Device Status Table 




T.TRB 


Trace Buffer 




T.SEQ 


Sequencer Table 




T.INS 


Installation Area 




T.MST 


Mounted Set Table 




T.DDT 


Dismounted Device Table 




T.VRNBUF 


VSN Buffer 




T.TAPES 


Tapes Table 




T.MAI L 


Scheduler Mailbox Butter 




T.IDT 


Logical I D Table 




T.DFB 


Dayfile Buffers 




T.PJT 


Parameter Storage for Delayed PP Jobs 




T.SSCT 


Subsystem Control Table 




T.SCHPT 


(Optional) Scheduler Statistics 




T.SCHJCA 


Scheduler Job Control Area 




T.SCHJDT 


Scheduler Job Descriptor Table 




T.BCFAP 


CPMTR CEFAP Buffer 



T.PPOVL 
T.AREA 
T.ENTRY 
T.DOT 



T.BR KPT 
T.EPAGE 
T.ECSPRM 
T.LIB 



PP Resident Overlay Save Buffer 

Area Table (ECS System) 

Entry Table (ECS System) 

Device Overflow Table 

CM Resident Programs (Disk System) 

Segmented System Areas (ECS System) 

Breakpoint Table (ECS System) 

Empty Page Stack 

ECS Parameters 

Library Directory 

INTERCOM Pointer Area 

INTERCOM Buffers and User Tables 



(Job control point user field length) 
T.RBT RBT Chains 



•Table Must Begin Before 10000B 
*Table Must Begin Before 20000B 
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CMR POINTER AREA 

59 

t 

' . P.AAZ, 

P.LIB 



P.RBR 
P.RBT 
P.CMLWA 

P.NPP 
P.NCP 
P.DFB 

P.SEQ 
P.FNT 
P.HEC 

P.CST 

P.PCOM 

P.EST 



P.PFM1 

P.MST ) 

P.DDT 
P.DSMO ) 



P. INS 



P.EIRPR 



47 



35 29 



23 



11 



P.ELBST 



P.RQS 



P.TAPES 



P.STG 



P.INT 



P.MFL 



ABSOLUTE ADDRESS ZERO 


C.DIRFWA 

■ | FWA of Library 
A j Directory 




LWA+1 
Library Directory 


CDS FLAG 
Deadstart 
Load Flag 


C.RBRAD 

1 FWA of RBR Area 


C.RBTEC 

RBT Ordinal 
of Empty Chain 


Length/100B of 
RBT Area 


C.CMLWA 
(LWA+1 )/100B 
of CM 


FWA/10B 
of Dayfile Buffer 


(Reserved) 


C.NPP 

No. of PPs 


C.NCP 

No. of CPs 


C.FNT 

FWAof 
FNT 


C.FNTLWA 
LWA+1 of 
FNT 


C.SEQ 

T.SEQ/10B 


C.SEQL 

L.SEQ 


C.HEC 

Hardware 
Error Count 


C.EST 

FWAof 
EST 


LWA+1 of 
EST 


C.CST 

FWA of CST 


C.CSTL 

LWA+1 of 
CST 


C.PCOM 

Address of 
Comm Area PP1 


(Reserved) 


C.APFL 

No. of APF 
Entries 




C.APF 

FWA of APF 


C.PFMCH 
Interlock 
Byte 


C.DSMO 
sys. 
set 


def. 
PFset 


C.NDDT 
n.fddtI N.VDDT 


C.DDT 

T.DDT/10B 


C.NMST 

L.MST 


C.MST 

T.MST/10B 


(Reserved for Installations) 


C.LEPAGE 
L.ECSTK+1 




C.ECSPRM 
T.ECSPRM 


ICC Area Address 


Maximum Length/ 

1000B of ECS 

Library File 


ECS Flaw Table Address 


ECS Page Stack Address 


C.DAT 

T.DAT 


C.DATL 

L.DAT 


C.RQSFS 

FWA/2 of 
Request Stack 




No. of 
DST 

Entries 


FWA/10B 
of DST 


C.TAPES 

T.TAPES/10B 


L.TAPES 


Reserved 

i 




C.STG 

T.STG 


C.INT/C.IFL 
(LWA+1 )/100B 
of INTERCOM 


C.ITABL 

FWAof 
Multiplexer Table 


C.IBUFF FWAof INTERCOM 
■ • Pointer and 
|B| Buffer Area 


C.ILTABL 
Length of 

Multiplexer Table 




C.MFL 

max. job FL/100B 



10 



11 



12 



13 



14 



15 



16 



17 
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NOTES: CMR POINTER AREA 

These descriptions begin with the location number and the symbol. Contents of words may change in the 
released version of system. 

P.AAZ 

Contains absolute address zero 



1 P.LIB 



A library change flag appears ,in bit '59. Right justified in bytes and 1 is the first word address of the 
library directory; bytes 2 and 3 contain the right justified last word address plus one of the library direc- 
tory. Byte 4 contains deadstart load flags. 



Bits in the byte C.DSFLAG are: 

S.SYSEDT 

1 

2 S.MFLVL 

3 S.CMU 



S.ECSLVL 



5 S.USETS 

6-7 S.IOLVL 



8-9 



S.SYSLVL 



10-11 S.ACTION 



l=Bypass EDITLIB GO/DROP message (internal to deadstart) 

Not used 

0=First mainframe to deadstart 

l=Not first mainframe to deadstart 

Compare/move availability indicator 

0=Not available 

1= Available 

ECS level 

0=No ECS 

1=ECS up 

l=Validate user sets 

00=Recover I/O queues 

01=Do not recover I/O queues 

10=Initialize 

System level 

00=A 

01=B 

10=C 

11=D 

System action 

00=Load 

01=Recovery 

02=Checkpoint recovery 



P.RBT/P.RBR/P.CMLWA 

Bytes and 1 contain the right-justified first word address of the record block reservation area. 
Byte 2 contains the record block table word-pair ordinal of the first member of the RBT empty 
chain. Byte 3 contains the current length of the RBT area in 100-word blocks. Byte 4 contains the 
current size of central memory in 1 00-word blocks. 
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NOTES: CMR POINTER AREA (CONT'D) 



3 P.DFB/P.NPP/P.NCP 

Byte contains the FWA/10 of the dayfile buffer area; bytes 1 and 2 are reserved for the 250 
graphics package. Bytes 3 and 4 contain the number of PP's and control points in the system, 
respectively. 

4 P.FNT/P.SEQ/P.HEC 

Bytes and 1 contain the FWA and LWA+ 1 addresses of the file name table. Bytes 2 and 3 
contain the FWA and length of the diagnostic sequencer table. Byte 4 contains the hardware error 
count. 

5 P.EST/P.CST/P.PCOM 

Bytes and 1 contain the FWA and LWA+ 1 addresses of the equipment status table. Bytes 2 and 
3 contain the FWA and LWA+ 1 addresses of the channel status table. Byte 4 contains the FWA 
of the communications area for PPL 

6 P.PFM1 

Number of empty attached permanent file table entries, FWA of attached permanent file table and the 

permanent file interlock byte are in bytes 1 to 4, respecitvely. 



Bits in the byte C.PFMCH are: 

0-10 

11 S.PFCIOQ 



Reserved 

PFC full flag - input jobs halted 



7 P.MST/P.DDT/P.DSMO 

C.DSMO Bits 1 1-6 MST ordinal for system set 

Bits 5-0 MST ordinal for PF default set 

C.NDDT Bits 11-6 Number of fixed DDT entries 

Bits 5-0 Number of variable DDT entries 

C.DDT T.DDT is the first word address divided by 10 octal of the dismountable device table 

C.NMST L.MST is the number of entries in the mounted set table 

C.MST T.MST is the first word address divided by 10 octal of the mounted set table 
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NOTES: CMR POINTER AREA (CONT'D) 

10 P.INS 

Reserved for installation use. 

11 P.EIRPR 



Byte contains the size of the ECS page stack; right justified in bytes 1 and 2 is the FWA of the ECS 
parameter table. Right justified in bytes 3 and 4 is the FWA of the ICC area address. 



12 P.ELBST 



Contains the ECS flaw table and page stack processor address. Byte contains the maximum size of the 
ECS library file in 1000-word pages. 

13 P.RQS 

Bytes and 1 contain the FWA and length, respectively, of the device activity table. Byte 2 contains 
FWA/2 of the request stack. Right justified in byte 3 is the current number of device status entries. 
FWA of the device status table is in byte 4. 

14 P.TAPES 

Bytes and 1 contain the FWA/ 10 and length of the tape configuration table. 



15 P.STG 

The FWA of the tape staging table is in byte 4. The rest of the word is currently unused. 

16 P.INT 

Byte contains the (LWA+1)/100B of the INTERCOM pointer and buffer area. Byte 1 contains the 
FWA and byte 4 the length of the INTERCOM multiplexer table. Bytes 2 and 3 contain the FWA of 
the INTERCOM pointer and buffer area. Bit 30 is a flag which is nonzero when deadstart is in progress. 

17 P.MFL 

Byte 4 contains the maximum job field length (MFL)/100B. 
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NOTES: CMR POINTER AREA (CONT'D) 



59 



47 



41 



35 



23 



17 



11 



T.JDATE 



P.NRBR 



T.BJDT 

P.EVICT \ 
P.RMSBUFI 

P.SSCT > 

P.SXDT I 

P.ELST / 
P.CMFL 



T.CPJOBN \ 
P.PJT } 

P.SPDROPJ 

T.EPBL | 
P.ECSFL j 

T.CLK 

T.SLAB1 J 
T.DATE J 

T.SLAB2 



T.SLAB3 



T.SLAB4 



T.SLAB5 



T.SLAB6 



T.MSP 



(Leading Zeros) 



C.N RQS Number 
of Request Stack 
Entries 



C.NRBR 
Number of 
RBR Headers 



Ordinal Date in 
Binary (YYDDD) 



C.LRBR 



Reserved 



Size of Total 
RBR Area 



Time in Binary 
(HHMMSS) 



C.ELST 
T.ELST/10B 



C.SSCT 
T.SSCT/10B 



C.RMSBUF 

T.RMSBUF 

FWA of RMSBUF 



Trace Buffer 
T.TRB/10B 



Machine 
FL/100B 



A 



M 



A 



A 



A 



Job Sequence 
Number 



C.SPDROP 
DST Ordinal 
for 1SP Drop 



C.ECSPL 



ECS Page Length 



Job Count 



C.PJTFWA 
T.PJT/10B 



C.ECSBL 



ECS Buffer Length 



C.PJTLWA 

T.PJT/10B+ 

L.PJT/10B 



C.CPECFL 

Machine 

ECSFL/1000B 



M 



M 



M 



M 



System Label 

SCOPE 

Version 

3.4 



Reserved 



PP Name if in Step Mode 



t 



Reserved 



Reserved 



L. i 



Step Flag 



20 



21 



22 



23 



24 



25 



26 



27 



30 



31 



32 



33 



34 



35 



36 



37 



Step Mode 
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NOTES: CMR POINTER AREA (CONT'D) 

20 T.JDATE 

The current ordinal date is stored here in the form yyddd with leading zeros. 

21 P.NRBR 

Byte contains the number of entries in the request stack; byte 1 contains the number of RBR headers; the 
length of the RBR area is right justified in bytes 3 and 4. 

22 T.BJDT 

The current ordinal- date in binary form is stored in bits 42-59; the current time, representing hours, minutes, 
and seconds in binary form, is stored in bits 0-17. 

23 P.EVICT/P.RMSBUF/P.SSCT/P.SXDT/P.ELST 

The FWA of the trace buffer, divided by 8, is stored in byte 4. The first word address of the rotating 
Mass Storage Buffer is stored in byte 3. The FWA of the subsystem control table, divided by 8, is 
stored in byte 2. 

24 P.CMFL 
Contains in byte 4 the current machine core size in 100-word blocks. 

25 (W.CPJNAM) 
Contains control point zero job name in the form SYSTEM 

26 T.CPJOBN/P.PJT/P.SPDROP 

Bytes and 2 contain the job sequence number and job count, respectively. FWA and LWA+1 of the 
parameter storage area for delayed PP job is in bytes 3 and 4. Byte 1 contains the current DST ordinal 
to be used to drop 1 SP. Before MTR initialization, byte 1 may be used to reserve additional PPs for stack 
processor. 

27 T.EPBL/P.ECSFL 

Right justified in bytes and 1 is the ECS page length as set by IP.EPAG; right justified in bytes 2 and 
3 is the ECS buffer length set by IP.EBUF. Byte 4 contains the total number of ECS pages assigned 
to direct access. 
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NOTES: CMR POINTER AREA (CONT'D) 

30 T.CLK 

Current display clock time in the format: 
hh.mm.ss. 

31 T.DATE/T.SLABI 

Current calendar date is in the format: 

mm/dd/yy (entered by operator) 

This is the first of a 6-word system display label. 

32 (IP.SYSLI)T.SLAB2 

33 T.SLAB3 

Words 32 and 33 provide storage for up to 20 characters for the system display label first line 
as given by installation parameter. 

34 <IP.VER)T.SLAB4 
System version identification. 

35 (IP.SYSE) T.SLAB5 
System edition date. 

36 T.SLAB6 

Used by system dynamic dump. 



37 T.MSP 




Bits in word 37 are: 




59-48 


Reserved 


47-30 


Name of PPU routine in step mode 


29-28 


Reserved 


27-24 


Control point number (0=entire system) 


23-13 


Reserved 


12 


l=step mode; 0=no step 


11-0 


Communication byte 
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NOTES: CMR POINTER AREA (CONT'D) 



59 



47 



35 



23 



11 



T.MSC 



P.CHRQ 



P.PPLIB 



P.VRNBUF 



T.CPSTA 



T.CPSTB 



T.MXNCTL 



T.PPID 



T.PPIP 



T.CMPID 



C.VRNFWA 
T.VRNBUF/10B 



T.SPF 



Count of PP 

Job Queue 

Entries 



Number of 
Idle PPs 



Number of Seconds*4096 



Position of CIO 







C.VRNFIN 
Pointer to 
First VSN 



Idle Exchange 
Package Address 



Number of 
Programs 



C.STGFLG 

Stage 
ON/OFF 



Next Slice Time 



C.CHRQ 
First 10 

Channels 



C.CHRQ2 

Second 10 

Channels 



Address of 
First PPLIB Entry 



2 



C.VRNINT 


C.VRNFUL 


Buffer 


Buffer Full 


Interlock 


Flag 



Active XP Address 











oooooooooooooo 



STL Code 



20 



Active XP Address 



* * * 




PP Input 
Register Address 



PP Input 
Register Address 



Computer ID for ECS Partitioning 



(Reserved) 



C.SNTLWA 
Length of Spot 
Name Table 



C.SNTFWA 
FWA of Spot 
Name Table 



C.CPN 

Station Control 
Point Number 



(Reserved) 



T.RCHN 



T.CPT1 
T.UAS 



! 



T.ECSPAR* 
P.EPAGE / 



SPM-1 RN Communications Word 



Unassigned 
CM/100B 



Unassigned 
ECS/1000B 



C.EPAGE 
T.EPAGE 



ECS Size 



ECS Flaw 
Table Flag 



First RBT 
Word Pair 
to Release 



Initial CPMTR 
Address 



ECS Parity 
Flag 



40 



41 



42 



43 



44 



45 



■JOB MODE 
• Rescheduling 



•—OFF 

EXN 
MXN 



MAN 



ECS Parity 
Address/ 1000B 



47 



50 



51 



52 



53 



54 



55 



56 



57 



-1! 



Turned Off 
Locked Off 



{! 



CPUA 
CPUB 
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NOTES: CMR POINTER AREA (CONT'D) 

40 T.MSC 

Real time clock (microsecond count) in bytes 2 through 4. Count of jobs in PP job queue in byte 0; 
a count of idle PPs is in byte 1 . 

41 P.CHRQ 

Active channel request queue flags for the first 10 channels in byte 3; for the second 10 channels in 
byte 4. 

42 P.PPLIB 

Byte contains the current position of CIO; the number of programs in the system library is given 
in byte 2. The address of the first library table entry is right-justified in bytes 3 and 4. 

43 P.VRNBUF 

Contains volume serial (visual reel) number buffer information and tape staging flags. 

44 T.CPSTA 

45 T.CPSTB (one word for each CPU) C.CPUOFF is a pointer to byte 3. 

Value while the CPU is running in job mode: 

59 41 35 23 17 



Idle Exchange Package 




Next Time Slice 


2 


Active Exchange 
Package Address 



Value while an MXN version of CPMTR is selecting the next job mode: 
59 41 23 



Idle Exchange 
Package 


****** 


03 03**** 



Value while the CPU is turned off: 
59 41 



23 



Idle Exchange 
Package 


****** 


OOOL* *** 
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NOTES: CMR POINTER AREA (CONT'D) 
4d T.MXNC1I. 

Value while in EXN mode: 



59 


































































































p 



Value while in MXN mode: 



59 


35 




29 




11 







STL Code 


2 





Active 

Exchange Package 

Address 


2 


6 1 


P 



Value while in MAN mode: 



59 




35 


29 




11 











STL Code 


2 


* » i 


• * • 


2 


6 


2 


P 



This word contains PP executable code. It is used by PP resident to perform the MXN for any CP 
monitor function. 

P = or 1 . The CPU number of the CPU that is running the lower priority job. CPMTR sets this and the 
active exchange package address at which the job is running. 

47 T.PPID 

Byte 4 contains the PP input register address of a PP that is waiting for a CPMTR function. 

50 T.PPIP 

Byte 4 contains the PP input register address of a PP that is waiting for a PPMTR function. 

51 T.CMPID 

Computer ID for ECS partitioning. 

52 Currently reserved. 
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NOTES: CMR POINTER AREA (CONT'D) 

5 1 I SIM 

The length and the first word address of the spot name table are in bytes 2 and 3, respectively. The 
station control point number is in byte 4. 

54 Currently reserved. 

55 T.RCHN 

First RBT word pointer of the chain to be released in byte 4. The rest of the word contains the 
SPM-1RN communications word. 

56 T.UAS/T.CPT1 

Byte contains the number of unassigned CM 100-word storage blocks; byte 1 contains, the number of 
unassigned ECS 1000-word blocks. Byte 2 contains the current size of ECS. Bytes 3 and 4 contain, right- 
justified, the initial program address of the CM monitor. 

57 T.ECSPAR/P.EPAGE 

Right adjusted in bytes and 1 is the FWA of the ECS page stack. Byte 2 contains ECS flaw table full 
flag; byte 3 contains ECS parity flag; byte 4 contains ECS block address in which parity error occurred. 
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NOTES: CMR POINTER AREA (CONT'D) 

59 47 



35 



23 



11 



P.SCH 



P.STR 



T.SCHCP 



T.SCHPP 



P.MAIL 
P.SWPECS 
P.SCHPT I 



P.LN 
P.IDT 



n 



P.AREA 
P.ENTRY 

P.ZERO 



P.PPOVL 
P.FDD 



C.LEJDT 



LE.JDT 



C.NFL 
Needed 
FL/100B 



C.SRS 
T.XPSCH/10B 



C.JQP 

Queue Priority of 

Job in Counter 



C.JCA 

T.SCHJCA/10B 



C.RFL 
Reserved 
FL/100B 



C.LJDT 
L.SCHJDT 



C.RCL 
C.STMF 

SCH Recall 



C.JDT 
T.SCHJDT/10B 



C.AFL 
Available 
FL/100B 



Interlock Word (Scheduler) 



Interlock Word (PP Routines) 



(Reserved) 



C.MAILF 
T.MAIL/10B 



C.ECSLNK 



C.MAILL 
L.MAIL 



C.SWPECS 
L.ECSSWP 



(Reserved) 



FWA of Breakpoint 
Table T.BR KPT 



C.SCHPT 

T.SCHPT/10B 



C.LIDT 

Length of 
ID Table 



FWA of Entry 
Table T.ENTRY 



C.ISIZLN 
INTERCOM 
User Table 



C.IDT 

T.IDT/10B 



FWA of Area 
Table T,AREA 



(zeros) 



(Reserved) 



C.FDDCT 
Dump count 



C.FDDLOK 
Dynamic dump 
recall flag 



C.FDD 
Dynamic dump 
FNT address 



C.PPOVL 
T.PPOVL/10B 



Reserved 



60 

61 

62 

63 

64 

65 

66 

67 
70 

71-76 
77 



NOTES: CMR POINTER AREA (CONT'D) 

60 P.SCH 

Contains information relative to the integrated scheduler. Pointer to job scheduler exchange package is in 
byte 1; a pointer to the job control area is in byte 2; length and pointer to the job description table is 
in bytes 3 and 4; length of job description table entries is in byte 0. 

61 P.STR 

Information relative to job scheduling. Communication word for scheduler/MTR. 

62 P.SCHCP 

Interlock word for integrated scheduler. 
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NOTES: CMR POINTER AREA (CONT'D) 

63 P.SCHPP 

Interlock word for PP routines. 

64 Currently reserved. 

65 P.MAIL/P.SWPECS/P.SCHPT 

Pointer to and length of scheduler mailbox buffer in bytes and 1 , respectively. The ECS swap flags 
are in byte 2. Pointer to the job scheduler is in byte 3. INTERCOM user table page size or line length 
is in byte 4. 

The ECS swap flag values are: 

Swap INTERCOM jobs to ECS at end of job. (EOJ bit set) 

1 Swap batch jobs in central memory queues to ECS 

2 All INTERCOM and graphics jobs are to be swapped 

3 All batch jobs are to be swapped 

66 P.IDT/P.LNK 

ECS link restart time control mask is in byte 0. Length of the ID Table is in byte 3. T.IDT/10B is in 
byte 4. 

67 P.AREA/P.ENTRY 

Pointers to the first word address of the breakpoint table, the area table and the entry table used for 
ECS systems. 

70 P.ZERO 

Contains a full word of binary zeros; a PP can clear five bytes at a time by reading this location. 
Changing the contents of this word will destroy system operation. 

71-76 Reserved 

77 PJPPOVL/P.FDD 

Byte contains a count of dumps on the system dynamic dump file. 

Byte 1 contains flag bit S.FDDLOK(0) set by routines that wait for IDD to complete, and cleared by IDD. 

Byte 2 contains the FNT address of the system dynamic dump file. 

Byte 3 contains the FWA of the PP overlay table. 

100 T.CST 

Entries for the channel status table. 
154 TJPPSn 

One word entries containing status information for up to 20 PPs. 
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CHANNEL STATUS TABLE 



T.CST 



i 



59 




47 


35 


26 


23 




11 







OOOOB 


C.CSTCN 
Channel Number 


C.CSTCB 


GC 


X 


Y 








• 

















100 



i 



53 



C MMTC Conversion Table, MMTC Equipment Numbers 4-7 

00 No Table 

01 EBCDIC 

10 ASCII 

1 1 Reserved 

G Normal Charge for Channel Time 

1 Do not Charge Control Point for Channel Time (S.CSNC) 

X Address of this word 

Y Same as X when channel not reserved 
PPIR address when reserved 



CHANNELS 




00-13 


Hardware channels 


14 


CH.FST 


15 


CH.FNT 


16 


CH.OOT 


17 


CH.RBT 


20-33 


Hardware channels 


34 


CH.CPA 


35 


CH.PFM and CH.APF 


36 


CH.INS 


37 


CH.MST 


40 


CH.EST « CH.TAPE 


41 


CH.ICOM 


42 


CH.IEMBP 


43 


CH.IUSER 


44 


CH.SCH 


45 


CH.IHUSR 


46 


CH.IHSMT 



(Controls access to FST) 
(Controls access to FNT) 
(Dismountable device table interlock) 
(Controls access to RBT) 

(Control point area interlock) 

(Permanent file manager and attached PF table channel) 

(For use by installation) 

(Mounted set table interlock) 

(Controls access to EST/TAPES table) 

(INTERCOM/SCOPE communication interlock) 

(INTERCOM empty buffer channel) 

(INTERCOM user table channel) 

(Scheduler channel) 

(High speed user table channel) 

(High speed empty buffer channel) 
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PP STATUS WORDS 



59 



T.PPS1 



Control 

Point 

Address 



47 



PP Status 



35 



23 



C.PPFAF 
Field Access Flag 



Channel I/O Time 



154 



177 



EXCHANGE PACKAGE 



59 


53 




35 




17 







P 


AO 


BO 




CMRA 


A1 


B1 






CMFL 


A2 


B2 




EM 


A3 


B3 


ECSRA 


A4 


B4 


ECSFL 


A5 


B5 


MA 


A6 


B6 




A7 


B7 










XO 

* 







X7 



10 



17 



EM •» Exit mode 

MA - Monitor address 

III -16 
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CONTROL POINT AREA 



47 44 41 



3S 



23 



23 



17 



11 



W.CPAn -$ 



W„CPSLIC\ 
W.CPUST } 

W.CPTIME 



W.CPTIMB 

W.PPTIME 
W.CPPTM 

W.CPSTAT 1 
W.CPFL \ 
W.CPEF } 

W.CPJNAM 



W.CPCC 



W.CPECS 



Exchange Package 



C.CPSTAT 
Status Byte 



C.CPSLIC 
M.RCLCP 
Time 



c.cpuqs ccpuqms 

CPU-A Seconds»4096 
This Quantum 



C.CPUQS CCPUQMS 

CPU-B Seeonds*4096 
This Quantum 



C.CPPQS C.CPPQMS 

PP Seconds*4096 

This Quantum 



C.CPMEMO 
Error Memo 



C.CPEF 
Error Flag 



* • • * 



C.CPUPRI 
G.CPLINK 

r 



Next Active 
Control Point 



C.CPUAS 
Total CPU-A Time as Number of Seconds*4096 



C.CPUBS 
Total CPU-B Time as Number of Seconds* 4096 



C.CPPTS 

Total PP Time as Number of Seccntfs*4096 



C.CPSM 
Storage Move 



C.CPRA 
RA/100B 



C.CPJNAM 



Job Name 



C.CPRPV 

Reprieve 

CKSM Value 



C.CPRPA 



Reprieve Address 



C.CPNFL 
Nominal 
FL/1Q0B 



C.CPECRA 
ECS RA/1QQ0B 



C.CPFL 
FL/100B 



JOT 

Ordinal 



C.CPNCSP 
Next Control 
Card Pointer 



C.CPECFL 
ECS FL/1000B 



W.CPDFM <& 



Last Day file Message 



W.CPPRI 
W.CPJCP 
W.CPTIML 
W.CPIOL ■ 
W.CPSWP i 
W.CPINT i 

W.CPSCH 
W.CPRO 

W.SSW 1 
W.CPSSW J 

W.CPMST 



W.CPCSF 



W.CPACS 



W.CPACSE 



CCPTIML C.CPIOL 

Current Time 
Limit ( 15 Bits) 



(O Time 
Limit (15 Bits) 



C.CPQNT 



Quantum 



C.CPFLG 
Swap Flags 



Saved SPOT 
Error Flags 



C.CPJQP 

Job Queue 

Priority 



C.CPPR! 
Job Class 



C.CPECSI 
Initial ECS 
FL/1000B 



CCPUTA 



User Table 
Address 



C.CPRFL 
Reserved FL 



C.GPFLI 

Initial 

FL/100B 



C.CPORG 
CCPEVNT job 
Flags | Origin 



C.CPJDA 



J0T Address 
(Absolute) 



Reserved 



C.CPSSW 

Sense 
Switches 



C.CPMST 
Setname MST 
Ordinal 



Gore Seconds Factor (Floating Point) 



(Reserved) Accumulated CM Core Seconds (Integer) 



(Reserved) Accumulated ECS Core Seconds (Integer) 



17 
20 

21 

22 

23 

24 

25 

26 

27 
30 

37 
40 

41 

42 

43 

44 

45 

46 

47 



A if set, do not update exchange package ECS RA and FL 
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CONTROL POINT AREA (CONT'D) 

59 47 41 

W.CPFACT 



W.CPFST 
W.FSTCC 

W.CKP 

W.CPCKP 

W.CPID 

W.CPOAE 

W.CPVRNO 
W.CPLDR1 

W.CPLDR2 

W.CPLDR3 

W.CPAR 

W.CPIOQ 

W.CPTAPE 

W.CPSTG 

W.CPDFMC 

W.CPDPV 

W.CPDSMO 

W.CPIRB 

W.CPFP 

W.CPOUT 

W.CPFUAG 

W.CPERT 

W.CPMSLM 
W.CHTIM 

W.CPMSI 

W.CPSR 

W.CPCAF 

W.CPCAL 
W.CPINS 



35 



23 



17 



11 



Account Parameter for Permanent Files 



FST Entry for Next Control Card PRU 



C.CPDID C.CPSID 

Destination Source 



ID 



C.CPREQ 
Req Flag 



BC 



ID 



Relative Address 
of Tape Label Information 



C.CPCON 

Console 
Checkpoint Flag 



C.CPCKP 
Number of 
Checkpoints 



C.CPOAE 

Equipment 
Assigned 



VSN Assignment 
66x VSN Type-tin 



C.CPLW 
C.CPLT 

Loader Flags 



Global Library 



Set 



1 

J L_J 



Indicators 



C.CPFLAG 
Flags 



RA+1 Contents (and Control Point Number C.CPAR 



of Last Auto-recall Request 



Reply Word Address 



C.CPTMT 
MT 



C.CPDFMC 
Dayfile 
Message Count 



C.CPTNT 
NT 



C.CPDSMO 
Default Set 
MST Ordinal 



C.CPMSLM 

MS Limit in PRU's 



CCPSITM 



Time of Swap-In 



C.CPSCPT 
System CP Count 



C.CPSR 

Stack 

Requests 



C.CPIOQ 



MST/PFC 
of Input File 



C.CPRBID 
INTERCOM Batch 
Routing ID 



C.CPFST 

FST Address 



C.CPMNT 
MT | NT 
Max Max 



C.CPDPV 
Job Dependency 

ID 
C.CPFP 
C.CPOUT 
Flags 



CCPMSMX C.CPMSRC 

Maximum PRU Count | Running PRU Count 



Channel Time as Number of Seconds*4096 



C.CPSCPL 

Long-term 

Connections 




CCPSCPA 

Wait-response 
Connections 



C.CPESR 

ECS 
Requests 



Control Card Buffer 



Reserved for Installations 



A S.YNRDY B S.YNNO C Extended label format 



50 
51 

52 
53 

54 
55 

56 

57 
60 

61 

62 
63 

64 
65 

66 
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NOTES: CONTROL POINT AREA 



W.CPLINK(20) 


CCPSTAT 


Bit 





S.CPUSTM 




1 


S.CPUSTY 




2 


S.CPUSTA 




3 


S.CPUSTB 




4 


S.CPUSTX 




5 


S.CPUSTW 




6 


S.CPUSTR 




7 


S.CPUSTC 




8 


S.CPUSTD 




9 


S.CPUSTS 




10 


S.CPUSTP 




11 


S.CPUSTZ 


W.CPEF(24) 


C.CPEF Values: 


0001 




F.ERTL 


0002 




F.ERAR 


0003 




F.ERPP 


0004 




F.ERCP 


0005 




F.ERPCE 


0006 




F.EROD 


0007 




F.ERK 


0010 




F.ERRN 


0011 




F.EREX 
F.ERCC 


0012 




F.ERECP 


0013 




F.ERJC 


0014 




F.ERPA 


0015 




F.ERRCL 


0016 




F.ERHANG 


0017 




F.ERMSL 


0020 




F.EROVL 


0021 




F.ERIOL 


0022 




F.ERRMS 


0061 




F.ERPARF 


-77(7700) 


F.ERMEMO 


-0(7777) 


F.ERTMM 


W.CPSWP(41) 


i C.CPORG Values: 


Value 


4 


Real time 




10 


Graphics 




20 


Multi-user 




40 


INTERCOM 


Bit 


6 


Swap out event bit 


W.CPSCH(42) 


C.CPFLG Values: 


Bit 


51 


S.CP1IB 




52 


S.CPFFL 




53 


S.CPEOJ 




54 


S.CPCLR 




55 


S.CPRFL 




56 


S.CPROP 


60306500 G 







Move flag - move in progress 

Auto recall 

CPUA assigned only 

CPUB assigned only 

Recall status 

Wait status 

Real time job 

Active CPUA 

Active CPUB 

Control point activity suspended 

Suspended by check point 

Suspended by MTR (too many PP calls) 

CP time limit exceeded, sensed by MTR 

Arithmetic error, sensed by MTR 

PPU abort (M.ABORT), requested by PP 

CPU abort (ABT in RA+1), requested by program 

PP call error (garbage in RA+1) abort, sensed by MTR 

Operator drop 

Operator kill (batch job only) 

Operator rerun (batch job only) 

Control card error, set by 1AJ 

Control card error for INTERCOM job 

ECS parity error, sensed by MTR 

Job card error 

Pre-abort (batch job only) 

Auto-recall error, bad PP call 

Job hung in auto-recall 

Mass storage limit exceeded (batch job only) by stack processor 

PP overlay not in PP LIB 

I/O time limit exceeded, sensed by MTR 

Dayfile lost on idled device 

Swap-in parity error for graphics 

Enter MEMO Mode 

Terminate MEMO Mode 



1 IB operating at control point 

FNTs in positive FL 

End of job 

Control point area clear request 

Storage request 

Roll out in progress 
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NOTES: CONTROL POINT AREA (CONT'D) 



W.CPSCH(42) C.CPFLG Values: 
Bit 57 S.CPS1P 

58 S.CPSOP 

59 S.CPSWC 



(continued) 

Swap in in progress 
Swap out in progress 
Swap out complete 



If nonzero, permanent file accounting messages are issued 

Left-justified account number 
C.CPCON 
Console checkpoint request 



W.CPFACT(SO) 

Bit 11-0 
59-12 

W.CPCKP(52) 

Bit 

W.CPLDR1(55) 

Bit 

1 

2-3 

4 

5 

6-9 

10 

11 

W.CPLDR1(55) 
W.CPLDR2(56) 

W.CPLDR3(57) Global Library Set Indicators: 

00 End of global library set 

01-76 LNT ordinal of system library . wrwiww 

77 Ifn of first user library in W.CPLDR3; Ifn of second user library in W.CPLDR2 



C.CPLW 

S.CPLP 

S.CPLT 
S.CPLR 
S.CPLM 

S.CPLV 



Reserved for installations 

Program loaded from nonsystem library 

Reserved for CDC 

Debugging aid flag 

Reduce flag 

Map options 

Reserved for CDC 

Map options validity flag 



W.CPFLAG(63) 



Bit 





1-2 

3 

4 

5 

6 

7 

8 

9-11 



W.CPFP(63) 
Bit 





1 

2 

3 

4 

5 

6 

7 

8 

9 

10 

11 



CCPFLAG 
S.CPLDAF 

Reserved 

S.CPNFNT 

S.IOL 

S.CPL 

S.MSL 

S.CPXTS 

S.CPDMPX 

Reserved 

C.CPFP 

S.CPL 

S.CPG 

S.CPA 

S.CPS 

S.CPN 

S.CPX 

S.CPDP 

S.CPEOR 

S.CPJFL 

S.CPJ 

S.CPR 

S.CPE 



MDI interlock 

Do not search FNT 
I/O time limit previously set 
CP time limit previously set 
MS time limit previously set 
Look for next EXIT(S) card 
Give no DMPX 



Reprocess 

Abort 

No rerun 

Sequencer 

Checkpoint taken 

Look for EXIT card 

Private disk pack 

Control card EOR 

Job card field length assigned 

JANUS 

Remote Batch 

Intercom 
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SYSTEM JOB EXCHANGE PACKAGE AREA 



59 



47 



35 



29 



23 



17 14 11 



T.XPSCH 



J 



^ 



W.CPSLIC 
W.CPUST 
W.CPLINK 

W.CPTIME 

W.CPTIMB 

W.PPTIME 

W.XPIR 

W.XPOR 

Scheduler Only 
T.SCHRS 

T.MTRRS 
T.XPIOLA 



W.CPSLIC 
W.CPUST 
W.CPLINK 

W.CPTIME 

W.CPTIMB 

W.PPTIME 

W.XPIR 

T.XPIOLB 



W.CPSLIC 
W.CPUST 
W.CPLINK 

W.CPTIME 

W.CPTIMB 
W.PPTIME 
W.XPIR 



Exchange Package 

for 

Scheduler and Storage Move 



¥ 



C.CPSTAT 
Status Byte 



C.CPSLIC 

M.RCLCP 
Time 



C.CPUPRI 
C.CPLINK 



Next Active 
Control Point 



CPU-A Scheduler/Storage Move Time 



CPU-B Scheduler/Storage Move Time 



PPU Idle Time 



Scheduler Input Register 



Scheduler Output Register 



Scheduler Request Stack Table 



L.SCHRS=4 



CPMTR MTR Request Stack 



L.MTRRS=4 



CPU-A Idle Program Exchange Package 
P=CPMTR (If IP.ECSB^, 

FL=400000B ECS FL=1 77777778 

B2=1 B5=L.ECSTK 

B7=0 A6=T.EPAGE) 



C.CPSTAT 
Status Byte 



C.CPSLIC 
M.RCLCP 
Time 



C.CPUPRI 
C.CPLINK 



Next Active 
Control Point 



CPU-A Idle Time 



% 



(If IP.MCPU="2) CPU-B Idle Program Exchange Package 
P-CP.MTR (If IP.ECSB¥0, 

FL=400000B ECSFL-17777777B 

B2«1 B5=L.ECSTK 

87=1 A6-T.EPAGE) 



C.CPSTAT 
Status Byte 



C.CPSLIC 
M.RCLCP 
Time 



C.CPUPRI 
C.CPLINK 



Next Active 
Control Point 



CPU-B Idle Time 



t? 



J* 
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PP COMMUNICATION AREA 



FOR PPO 





59 


17 







W.PPIR 


CPCIO Output Register 


W.PPOR 


MTR Output Register 


W.PPMES1 




Stack Request Parameters 








W.PPMES2 






W.PPMES3 


7HDAYFIIE 




000030 




W.PPMES4 





W.PPMES5 


7HCERFILE 


000030 


W.PPMES6 














Extend for 
System Day file 



Extend for 
CERFILE 



FORPP1 



W.PPIR 
W.PPOR 
W.PPMES1 
W.PPMES2 
W.PPMES3 
W.PPMES4 
W.PPMES5 
W.PPMES6 



DSD Input Register 



DSD Output Register 



Stack Request Parameters 



Control Point 
Message Buffer 



DSD - 1 DL Communication Word 



z 
o 

5< 

— HI 

3 < 

2 
5 

O 
o 



| 11-1-22 
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PP COMMUNICATION AREA (CONT'D) 
FOR PP2 THROUGH PPn 

59 39 35 



W.PPIR 


| C.CPNUM 
Program Name or 


I 


W.PPOR 


MTR 

Function 

Code 




*-*- Control Point No. 
<— Recall 

Called from event or delay stack 


W.PPMES1 




STACK REQUEST PARAMETERS 


< 


i 


W.PPMES2 




s 


W.PPMES3 




COMMUNICATION WORD 


K 

< 

Z 

g 


W.PPMES4 




EVENT STACK PARAMETERS 


< 
| 

« 

. c 

c. 


t 
5 


W.PPMES5 




5 
> 


W.PPMES6 










" 



COMMUNICATION WORD 

59 



47 



35 



23 



17 



11 



C.RWPPCF 

Control 

Point 



C.RWPPWT 


C.RWPPLW 


C.RWPPCC 


C.RWPPWC 


Cumulative 


PP Buffer 


C.RWPPST 


Current PRU Byte 


Byte Count 


Length 


I Code and 


Status Count 
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PP PROGRAM NAME RESERVATIONS 

Routine Name Description 

A* Stack processor segment 

ABS Dump CM — absolute address 

| ABT Program abort 

ACE Advance control card 

ACT Helper for program ACCOUNT 

ADS ADDSET processor - add member to PF set 

I APR C.E. diagnostic sequencer 

CEA Deadstart PPO save program 

CED Deadstart PP control program 

CEJ MTS coldstart bootstrap 

CEM Central error manager for ECS 

CEY MTS coldstart bootstrap 

CIO Circular I/O processor 

CKP Saves information necessary to restart a checkpoint job 

CLO Dummy program used to call CIO 

COM Deadstart option matrix 

CON INTERCOM connect file to remote terminal 

CPl C.E. 415 card punch test 

CR1 C.E. 405 card reader test 

CY1 Resets FNT of file being processed by restart 

D' Deadstart dump 

DF4 C.E. 3234 test 

DF7 C.E. 3553 test 

DF8 C.E. 808 test 

DIS Console display program for a control point 

DLE C.E. diagnostics 

DLM DELSET processor - delete member from PF set 

DMP Dump CM 

DMT Deadstart dump for 60x, 65x drivers 

DSD System display 

DSM Dismount pack 

DSP ROUTE/DISPOSE function processor 

DTS Deadstart dump for 66x drivers 

D00 Diagnostic for COBOL 

D03 C.E. 6603 test 

D21 C.E. 821 test 

D41 C.E. 841 test 

D44 C.E. 844 test 

END Normal termination 

EPF Send audit information to CM 



T Zero-fiiled 
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PP PROGRAM NAME RESERVATIONS (CONT'D) 

Routine Name Description 

FAD INTERCOM 

FNT INTERCOM FNT alter routine 

FSN Find set name 

FTP C.E. 580 printer test 

GBJ INTERCOM 274 Graphics begin job 

GEJ INTERCOM 274 Graphics end job 

GES INTERCOM 274 IGS SIGNON service program 

GPF GETPF(MMF) 

HDS Help deadstart 

IAP INTERCOM initiate another program 

IEF Routine for CEFAP 

IPP INTERCOM password protection 

IRP Deadstart RMS stack processor 

IUP INTERCOM initiate user program 

JAC Job queue acquire information 

JDP Job dependency count decrementor 

LBK C.E. load buffer controller 

LBL LABELMS header 

LCD INTERCOM LCC dump 

LDC LDCMR utility helper 

LDL Loader utility program 

LDV Loads CPU absolute overlays 

LDW Loads CPU absolute overlays in conjunction with LDV 

LOC Load octal corrections 

LPF In conjunction with LOADPF, reloads permanent files 

LPT C.E. 501 line printer test 

LP1 C.E. 512 line printer test 

MAC INTERCOM 

MDI Used by EDITLIB to handle I/O involved in changing and moving directory 

MDR Deadstart 66x driver 

MEM Process memory function 

MES INTERCOM writes messages to remote terminal 

MNT MOUNT processor 

MSD Direct Access Module of Record Manager 

MSG Issues dayfile messages 

MTR Monitor 

MTT C.E. 60X tape test 

MTZ C.E. 66X tape drive test 

MUJ INTERCOM multi-user job 

M71 C.E. 6671 multiplexor test 
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PP PROGRAM NAME RESERVATIONS (CONT'D) 

Routine Name Description 

NSV PP helper for CPVSN processor 

OPE Dummy program used to call CIO 

OUX TRANSPF and DUMPF utility helper 

Pf Deadstart preaddressed 6603 

PAK Disk pack management routine 

PFA Permanent file manager ATTACH function 

PFC Permanent file manager CATALOG function 

PFD Attaches Permanent File Directory to control point 

PFE Permanent file manager EXTEND function 

PFP Permanent file manager PURGE function 

PFR Permanent file manager RENAME function 

PFS Permanent file manager POSITION function 

PPI Reserved 

PRM Permission checking function 

QAC I/O queue acquire file 

QAF Queue Access Function 

QAJ Reserved 

RCL Temporarily relinquish CPU 

REQ Makes nonallocatable device assignment and formats FNT entries for allocatable devices 

in response to REQUEST control card or a REQUEST macro call 

RMS Routine for CERMS 

RPV Reprieve central program 

RST Restores control point area of restart job 

RWE INTERCOM checks for INTERCOM job 

SAC ECS Segment Activity counts 

SLT Reserved 

SPF SAVEPF(MMF) 

SPY Count P-regjster samples for CP programs 

SPZ PP helper for SPY 

SRB Used by EDITLIB to complete the disk address of a record 

SSC Sub-system call 

SSF Sub-system function 

SSH Station system helper 

STD Enhanced station channel coupler driver 

STL Deadstart system execution PP resident 

STS Used by CP program to obtain certain status 

TAT PF set table system access 

TBL INTERCOM get table 

TDR Deadstart MT-NT tape driver 

TDS Terminate deadstart 

TIM Get current time, date, etc. 



^Zero-filled 
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PP PROGRAM NAME RESERVATIONS (CONT'D) 



Routine Name 

TMT 
T5X 
T6X 
T76 

Uxx 

VEJ 
VSM 

XDQ 

nUx 

OFA-OFZ 
0F0-0F9 
OZA-OZS 
OZT-OZZ 
0Z1-0Z9 

1AB 

1AJ 

1BO 

1BR 

1BT 

ICC 

1CI 

1CL 

1CR 

1CS 

1CT 

1C9 

1DD 

IDF 

1DL 

1DM 

IDS 

1DU 

1EJ 

1EV 

1FC 

1FE 

1FM 

1GJ 

1GM 

1GR 

1GS 

1IB 

HD 

1IM 



Description 

Table maintenance helper 
C.E. 65X tape drive test 
C.E. 66X tape drive test 
INTERCOM 

Reserved for installations 

Verify job statement 
STIMULATOR routine 

PP portion of dump queue 

Reserved for installations 

INTERCOM Front End Initializer 
INTERCOM Front End 2550 software 
LCC drivers 
LCC initializer 
LCC drivers 

Identifies recovered jobs 

Advance job 

Asynchronous job terminator 

INTERCOM Buffer Manager 

Blank label tape routine 

Enhanced station CIO overlay 

INTERCOM Queue Manager 

Close function for all non-tape or non-permanent files 

Tape read recovery - write CM for 9-track tapes 

Tape read recovery — write CM for S tapes 

Tape read recovery — write CM for SCOPE tapes 

Write CM for tape read recovery — NT SCOPE tapes 

System dynamic dump processor 

Dump dayfile 

Overlay loader and dayfile message processor for DSD 

Device queue manager 

INTERCOM H-display 

DUMPF initialization 

End of job processor 

Off line evict processor 

Creates an RB entry for PFC 

INTERCOM Front End Driver 

Dummy film/hardcopy processor 

INTERCOM 

Issues GOOD MORNING when time changes from 23.59 to 00.00 

INTERCOM 

INTERCOM 274 IGS SIGNON initializer 

Initiate batch job from input queue 

INTERCOM send dayfile message to terminal, complete swap 

INTERCOM send message to terminal 
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PP PROGRAM NAME RESERVATIONS (CONT'D) 

Routine Name Description 

1IQ Initiate JANUS control point 

HR Main JANUS routine; drives readers punches, printers, etc. 

US Initialize overlay setup 

HT Integrated tape driver for (66x) main overlay 

HU Called by JANUS to backspace print file 

111 INTERCOM Initialization 

1LX INTERCOM 

IMF Multifile positioning routine 

1MH Tape scheduling/prescheduling routine 

1MM Multi-mainframe job queue manager 

1MN MNT overlay, PFD cleanup after compatibility mode used 

1MT Long record stranger tape driver 

1N0 Tape read recovery noise record verifier 

1NR NT read driver 

INS Notify station of SPOT completion 

1NW NT write driver 

1N2 Tape noise record read recovery, read forward 1 

1N3 Tape noise record read recovery, read forward 2 

10P File open routine for non-tape files 

IPC Close permanent file mass storage 

1PD Called by PFA to either enter event stack, call another PP routine, or swap out 

1PF Permanent fde error recovery 

1PG PURGE(MMF) 

1PK PF set coordinator 

1PL Dummy plot program 

1P1 Tape recovery to LGR positioning driver 

1P2 Tape recovery write driver 

1P3 Tape recovery verification driver 

1P4 Tape recovery to LGNR positioning driver 

1QF I/O file manager 

1QM INTERCOM check for MUJ swap-out completion 

1QP INTERCOM quantum calculator and MUJ servicer 

IRC Restores field length of a checkpointed job 

1RN Ages queues, manages RBT chains and statuses tape drives 

1RP End of reel processor 

IRS Read stranger tape driver 

1RT Read SCOPE tape driver 

1RV Tape I/O read recovery driver initializer and terminator 

1R2 Tape read recovery — tape parity error recovery 1 

1R3 Tape read recovery - tape parity error recovery 2 

1R9 SCOPE tape 9 track (659) read tape driver 

1SI Routine to swap-in or roll-in a job 

ISO Swap-out or roll-out a job 

ISP Mass Storage I/O processor (stack processor) 

1SX Error message and abort function for stack processors 

1S5 Load and execute ISP or 3DO at second entry 
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PP PROGRAM NAME RESERVATIONS (CONT'D) 

Routine Name Description 

1TF Tape forward motion routine 

1TJ Translate job card 

1TO Tape open routine 

1TR Read labels for non-66X drives 

ITS Tape sampler 

1VG STIMULATOR routine 

1WB INTERCOM wideband driver 

1WI SCOPE internal tape write driver 

1WS Stranger tape write driver 

1W9 SCOPE tape 9 -track (659) write tape driver 

1XG INTERCOM 1XP overlay used for graphics 

1XP-6XP INTERCOM high speed EXPORT processor 

1ZA-1Z9 INTERCOM drivers 

2CC 1CI overlay — process command 

2CS 1CI overlay — create user table 

2CU 1CI overlay — create user table 

2FC 1FC overlay replace mode 

2FE INTERCOM Front End Driver 

2GJ INTERCOM 

2IA 66x read driver for L tapes 

2IB 66x write driver for L tapes 

2IC 66x read driver for 7-track coded SCOPE tapes 

2ID 66x write driver for 7-track coded SCOPE tapes 

2IL 66x labels and tape module 

210 Submodule for 310 - 3IL 
2IP 66x/67x tape positioning 
2IR 66x basic read overlay 

2IS Reservoir of routines for IIS 

2IW 66x basic write overlay 

211 INTERCOM overlay to 111 
2LF LPF overlay broken connect 
2MN MNT overlay error processing 
2PA PFA utility processor 

2RP Overlay to lRP-End-of-reel processor 

2ST MMF CIO staging processor 

2TB All backward tape motion 

2TC Extended trailer label group processor 

2VJ Translate job card 

2WB INTERCOM overlay to 1WB 

2XP INTERCOM wideband directive processor 

3AM ADS overlay member processing 

3D0 Initialize allocatable device file 

3FC 1FC overlay compatibility replacement 

3FE INTERCOM Front End Driver 
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PP PROGRAM NAME RESERVATIONS (CONT'D) 

Routine Name Description 

3IC 66x close processor 

3IE 66x basic error processor 

3IF 66x multi-file processor 

311 66x system initialization 

3IL 66x label write processor 

3IM 66x message processor 

310 66x open processor 

3 IP 66x positioning within a logical file 

3IR 66x read error recovery 

3IS JANUS overlay 

3IV 66x close volume processor 

3IW 66x write error recovery 

3LX INTERCOM overlay to 1LX 

3MG Format request for REQ 

3MN REQ overlay for tape assignments 

3PA PFA swapper status check segment 

3PC PFC helper 

3PM Segment of 1P1 used for holding code for future use 

3P0 Segment of 1P3 that processes uncorrectable parity error GO or RECHECK code 

3PS Segment of 1P4 used for holding code for future use 

3RQ REQ overlay containing 2TAC0M 

3R2 Process mispositioning at load point for 1R2 

3R3 Process mispositioning at load point or hardware errors for 1R3 

3SP Stack processor for 6603-1 driver 

3SQ Stack processor for 6638 driver 

3SS Stack processor for 854 driver 

3ST Stack processor for 6603-11 driver ' 

3SV Stack processor for 821 driver 

3SW Stack processor for 841 driver 

3SY Stack processor for 844 driver 

3TT INTERCOM transmit data from CPU to terminal 

3T1-3T2 INTERCOM overlays to 3TT 

3WB INTERCOM overlay to 1WB 

3XP INTERCOM wideband batch input processor 

4AM ADSETT add number overlay 

4DO Process device independent requests for allocatable devices 

4ES Enter stack request 

4FC 1FC overlay compatibility replacement 

4FE INTERCOM Front End Driver 

4LB ANSI standard label processor 

4LC 3000 label processor 

4LX INTERCOM overlay to 1LX 

4PA PFA segment backspace pru 

4SD Enhanced station channel coupler driver overlay to STD 

4WB INTERCOM overlay to 1WB 

4XP INTERCOM wideband batch output processor 
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PP PROGRAM NAME RESERVATIONS (CONT'D) 

Routine Name Description 

5CP IRP overlay 6603-1 driver 

5CQ IRP overlay 6638 driver 

5CS IRP overlay 854 driver 

5CT IRP overlay 6603-11 driver 

5CV IRP overlay 821 driver 

5CW IRP overlay 841 driver 

5CY IRP overlay 844 driver 

5FE INTERCOM Front End Driver 

5LX INTERCOM overlay to 1LX 

5PA PFA segment error subroutine 

5WB INTERCOM overlay to 1WB 

SXP INTERCOM wideband batch banner page 

6BM Billing message overlay 

6BR ANSI label processor read function code overlay 

6BW 4LB overlay 

6CR 3000 label processor read function code overlay 

6CW 3000 label processor write function code overlay 

6FE INTERCOM Front End Driver 

6IM Issue conflict and abort messages for REQ 

6LC Segment of 4LB or 4LC to load conversion table into MMTC 

6LM Segment of 4LB used to construct tape label messages 

6LX INTERCOM overlay to 1LX 

6L1 4LB overlay to convert PRU count 

6L2 BCD conversion table overlay for 4LB 

6L3 4LB overlay to check that proper conversion table is in the MMTC 

6L4 4LB overlay for debug message writer 

6L5 4LB overlay to format the label information 

6L7 4LB overlay to pack and write label to tapes table 

6MD Dummy EDITLIB overlay 

6MN REQ overlay for tape assignments 

6N0 Tape error recovery debug segment assembled to give more detail about segment being 

read by 1NO 

6PA PFA segment-compatibility overlay 

6PD Write pre-dayfile 

6RD Disposed file accounting overlay 

6PM Permanent file accounting overlay 

6SI Process swap-in parity errors 

6WM Outputs dayfile error messages for I/O requests 

6XP INTERCOM wideband batch lace card 

7AJ 1AJ overlay for EXIT card processing 

7CC Enhanced station ,CIO overlay to ICC 

7EC Generate ECS buffers 

7FE INTERCOM Front End Driver 

7ID Auxiliary error processor for RMS I/O 

7NO Debug routine 

7RQ REQ Set Processor 

7T1 ASCII/Display code conversion table 

7X2 EBCDIC/Display code conversion table 

7W1-7W2 Overlay for 6WM 
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PP PROGRAM NAME RESERVATIONS (CONT'D) 



Routine Name 



Description 



8AA-8A9 

8BA-8B9 

8CA-8C9 

8DA 

8DB 

8DC 

8DD 

8DE 

8DF 

8DG 

8DH 

8DI 

8DJ 

8DK 

8DL 

8DM 

8DN 

8DO 

8DP 

8DQ 

8DR 

8DS 

8DT 

8DU 

8DV 

8DW 

8DX 

8DY 

8DZ 

8D0-8D4 

8EA-8E4 

8FA-8FD 

8FE 

8FF-8I9 

8GO 

8JA-8M9 

8NA-8PS 

8NO 

8PU-8W9 

8T3 

8XA 

8XB 

8XC 

8XD 

8XE 

8XF 

8XG 

8XH 

8X1 



Reserved 

Reserved 

C.E. reserved names 

A, I, J display overlay for DSD (dayfile buffers, REQUEST cards, JANUS) 

B display overlay for DSD (control point status) 

C, D, G display overlay for DSD (central memory) 

Reserved for DSD 

E display overlay for DSD (equipment status table) 

F display overlay for DSD (file name table) 

Reserved for DSD 

H display for DSD (I/O queues) 

Reserved for DSD 

Reserved for DSD 

K display overlay for DSD (pointers and control point area) 

L display overlay for DSD (central programmable) 

M display overlay for DSD (PP communications area) 

N display overlay for DSD (Breakpoint) 

O display overlay for DSD (operator message) 

P display overlay for DSD (tapes table and VSN previewing) 

Q display overlay for DSD (INTERCOM status) 

R display overlay for DSD (JDT tables and queues) 

S display overlay for DSD (job control area) 

T display overlay for DSD (transfer status-linked mainframe) 

U display overlay for DSD (ID table) 

V display overlay for DSD (RMS) 

W display overlay for DSD (pack requests) 
X display overlay for DSD (ECS memory) 

Y display overlay for DSD (command format dictionary) 
Z display overlay for DSD (display dictionary) 

DSD 

DSD (Linked mainframe displays) 

Reserved 

INTERCOM Front End Driver 

Reserved 

Loaded by 1R3 when GO or DROP operator decision necessary during tape processing 

Reserved for DSD alternate overlay names 

Reserved 

Segment to 1N3 that writes debug messages to dayfile if n > .DBUG=l 

Reserved 

Overlay to load MMTC memory 

Channel commands overlay for DSD 

Debugging commands overlay for DSD 

PPU calling control points requests commands overlay for DSD 

Equipment status commands overlay for DSD 

Control point commands overlay for DSD 

Deadstart commands overlay for DSD 

Priority and tape staging job control commands overlay for DSD 

INTERCOM commands for DSD 

Miscellaneous commands overlay for DSD 
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PP PROGRAM NAME RESERVATIONS (CONT'D) 



Routine Name 



Description 



8XJ 

8XK 

8XL 

8XM 

8XN 

8X0 

8XP 

8XQ 

8XR 

8XS 

8XT 

8XU 

8XV 

8XW 

8XX-8X7 

8X8 

8X9 

8YA-8Y9 

8ZA-8Z9 

9AA-9FD 

9FE 

9FF-9PS 

9PU-9Y9 

9ZA-9Z9 



Miscellaneous commands overlay for DSD 

Tape scheduling commands overlay for DSD 

Operator action manager commands overlay for DSD 

Error flag commands overlay for DSD 

CP-PP interlock commands overlay for DSD 

Initiate system jobs command overlay for DSD 

Tape assignment command overlay for DSD 

Bring up displays command overlay for DSD 

Divert a file command overlay for DSD 

Segment debug command overlay for DSD 

Segment debug command overlay for DSD 

RMS commands for DSD 

Logical ID command overlay for DSD 

ENID command overlay for DSD 

Reserved for DSD 

DSD command syntax table 

Reserved for DSD 

DSD (Linked mainframe commands) 

INTERCOM PP drivers 

Customer Engineering 

INTERCOM Front End Driver 

Customer Engineering 

Customer Engineering 

INTERCOM 



MONITOR FUNCTIONS 



01 


M.SETST 


Set CPU status bits 


02 


M.CLRST 


dear CPU status bits 


03 


M.RCP 




Request central processor 


04 


M.DCP 




Drop central processor 


05 


M.RCLCP 


Recall central processor 


06 


M.ICE/M.SPM 


Initiate central executive/SPM call from ISP 




00 


EX.CMSM 


CM storage move 




01 


EX.ECSM 


ECS storage move 




02 


EX.PUB 


PP library search 




03 


EX.SPM 


Call stack processor manager 




04 


EX.SS 


Systems second calculation 




05 


EX.SCH 


Call scheduler 




06 


EX.SCH1 


Call scheduler (storage request entry) 




07 


EX.REQEB 


Request ECS buffer 




10 


EX. R£LEB 


Release ECS buffer 




11 


EX.CBM 


Circular Buffer Manager 




12 


EX.SPRCU 


Stack processor recall 




13 


EX.STAT 


Change status 




14 


EX.NXTPB 


Get next PB/PRU 
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MONITOR FUNCTIONS (CONT'D) 



15 


EX.FLHB 


16 


EX.CSWAP 


17 


EX.AUTEB 


20 


EX.ECD 


21 


EX.ECR 


22 


EX.ECW 


23 


EX.CEM 


25 


EX.ECLDV 


26 


EX.BKSPF 


27 


EX.LNKON 


30 


EX.LNKIN 


31 


EX.BOOT 


32 


EX.TAT 


33 


EX.RBT 


34 


EX.SSF 


07 


M.CPUST 


10 


M.SUCE 


11 


M.SPRCL 


12 


M.RCH 


13 


M.DFM 


15 


M.STEP 


16 


M.RBTSTO 


17 


M.RSTOR 


20 


M.TSR 


21 


M.DPP 


22 


M.ABORT 


23 


M.RPJD 


24 


M.EESD 


25 


M.SEQ 


26 


M.SEF 


27 


M.ISP 


30 




31 


M.CCPA 


32 


M.RPJ 


33 


M.EES 


34 


M.CPJ 


35 


M.SCH 


36 


M.PASS 


37 


M.RACT 


40 


M.SCB 


41 


M.NTIME 


42 


M.NOTE 


43 


M.PPCH 


44 


M.BUFPTR 


45 


M.PATCH 


46 


M.TRACE 


47 


M.SLPER 


77 


M.KILL 



Flush buffer 

Clean ECS after ECS RPE in swap file 

Terminate automatic allocation 

Display ECS 

Release display 

Modify ECS 

Gear CEM-working flag 

Make successive partial reads of ECS record 

Release data in ECS from input buffer 

Restart ECS link driver 

Initialize MMF ECS link driver 

Start ECS system 

Lock RBR/RBT processing 

PRU conversion 

Subsystem function 

Change CPU status (IP.MCPU # 1) 

MTR interrupts CPMTR at end of time slice for job 

Stack processor recall 

Reserve channel 

Process dayfile message 

Enter step mode 

Request RBT storage 

Request storage 

Terminate storage request (IP.RTMTR # 0) 

Drop PP 

Abort control point and drop PP 

Request peripheral job and drop PP 

Enter event stack and drop PP 

Assign job sequence number 

Set error flag 

Initiate stack processor 

Not used 

Change control point assignment 

Request peripheral job 

Enter event stack 

Capture peripheral job 

Initiate integrated scheduler 

MTR ignores it — to be cleared by another routine 

Request control point activity 

System circular buffer surveillance 

Enter new time limit 

Null function, cleared immediately. Used as break point 

Request channel surveillance 

Buffer pointer address 

Enter a patch into MTR 

Turn on MTR trace 

XI to other CPU 

Bad monitor request made 
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EQUIPMENT STATUS TABLE 



EST FOR RMS DEVICE 

59 47 



35 33 31 29 



22 



11 



C. EST AT 



I, I, I I I l.l.l 



CPT 
No. 



C.ESTDL 
Device 
Label R8 



Eqp. 
No. 



Unit 
No. 



C.ESTMNE 
Device 
Mnemonic 



c 



C.ESTDST 
DST Ordinal 



n 



S.ESTBSY - Busy bit 
S.ESTFR - Free bit 



•S.ESTSHR - Shared device 
S.ESTRID - Wait dismount 
S.ESTRMS- RMS device 



ON/OFF Bit S.ESTON 
IDLE bit (S.ESTIDL) 



USE OF FREE, BUSY BITS 
Free Busy 









Unavailable device 


t 





Dismounted device 





1 


Mounted device 


1 


1 


Device in process of being dismounted 



MAGNETIC TAPE ENTRY 
59 51 47 



41 



35 



29 



23 



11 8 6 



C.ESTAT 

ojoooool 



i 



C.ESTCH1 
Channel I [Channel 
B 111 A 



t 



C.ESTCH2 
Channel I Channel 
DC 



t 



C.ESTMNE 
Hardware 
Mnemonic 



Eqp. 
No. 



rt 



Unit 
Number 



6681/6684 
U Control Point Number 
'—-Request tape status check of assigned unit 
Tape Status Check in Progress 



ON/OFF Bit 



MTS 
Bit 



MMTC 
Bit 



UNIT RECORD EQUIPMENT ENTRY 
59 51 47 44 41 



35 



23 



11 8 



C.ESTAT 

ooooooool 



Channel 



£ 



ti 



C.ESTSD 

Forms 
Code 



t 



C.ESTMNE 
Hardware 
Mnemonic 



Eqp 
No. 



Unit 
Number 



■External Characteristic Code 
Control Point Number 



ON/OFF Bit 
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EQUIPMENT STATUS TABLE (CONT'D) 



6612 DISPLAY CONSOLE ENTRY 

59 51 47 41 



35 32 29 



23 



11 



C. EST AT 

ol 



t 



C.ESTCH1 



Channel 



Eqp. 
No. 



Unit 
Number 



t 



C.ESTMNE 
DS 







Control Point Number 



*— Available Bit 



ON/OFF Bit 



MULTIPLEXER ENTRY 
59 47 



C.ESTAT 

ol 



41 



35 32 



27 23 



C.ESTCH1 

Channel 



Eqp. 
No. 



CIDVACT 



11 



t 



C.ESTMNE 
Hardware 
Mnemonic 



Index into 
MUX Subtable 



ON/OFF Bit 

Driver Ordinal (3 bits) 

Active Bit 



6000/7000 CHANNEL COUPLER 
59 47 



35 



23 



11 



C.ESTAT 

I. 


C.ESTCH1 

I Channel 


Eqp. 
No. 


000 


C.ESTMNE 
CC 


0000 



-Control Point Number 



-ON/OFF Bit 



DDP ENTRY 
59 



47 



41 



35 



29 



23 



11 8 



0000 



C.ESTCH1 
Channel i Channel 
__2 I 1 



C.ESTCH2 
Channel i Channel 
4 I 3 



C.ESTMNE 
ED 



Eqp. 
No. 



000 



L 



ON/OFF Bit 
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DEVICE CODES 



Mnemonic 

AA 
AB 

AC 
AL 
AM 
AP 



AY 



Device Type Description 

01 6603-1 disk 

02 6638 disk 

03 CDC reserved 

04 6603-11 disk 

05 821 data file 

06 841 multiple disk drive 

07 3234/854 disk pack drive 
10 

11 > CDC reserved 

12 j 

13 Reserved for 844 disk pack 



CDC reserved 



AX* 



ECS resident file 



CDC reserved 



LM 



link medium file 
Packet file FNT (MMF) 



Reserved for installations, RMS devices only 



Mt 

NT 



TR** 

Tp ** 



LP** 
LI** 
LQ** 
LR** 
LS** 
LT** 



CR** 
KB 



fSee following page 



7-track magnetic tapet 
9-track magnetic tapet 
Member file 7-track tapet 
Member file 9-track tapet 
Paper tape reader 
Paper tape punch 
Reserved for installations 
Reserved for installations 
Any available line printer 
501, 505 line printer 
512 line printer 
580-12 line printer 
580-16 line printer 
580-20 line printer 
Reserved for installations 
Reserved for installations 
405 card reader 
Remote terminal keyboard 
7-track multi-file set tapet 
9-track multi-file set tapet 

*No EST entry for this device code 
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DEVICE CODES (CONT'D) 





Device 


Mnemonic 


Type 


„, _ 


64 


-- 


65 


-- 


66 


— 


67 


CP** 


70 


DS 


71 


GC** 


72 


HC** 


73 


FE 




FM** 


74 


PL** 


75 


— 


76 


-- 


77 


DC 


-- 


DC 


-- 


Wx 


— 


Xx 


— 


SC 


— 


YC 


— 


CC 


- - 


CS 


— 


ED 


— 



Description 

Pseudo code for tape staging 

CDC reserved 

Reserved for installations 

Reserved for installations 

415 card punch 

6612 keyboard/display console 

252-2 graphic console 

253-2 hard copy recorder 

2550 Communications NPU 

254-2 microfilm recorder 

Plotter 

Reserved for installations 

Reserved for installations 

6671 DSC 

Reserved for installations 

Reserved for installations 

Reserved for installations 

6673/6674 DSC 

6676 DSC 

6000/7000 channel coupler 

7077-1 communications station (LCC) 

6642-1 distributive data path (DDP) 



I **Device type is defined but not supported by standard software. 



Low order 


7-track 


9-track 


6 bits (xx) 






00 


Hi-density (556 bpi) 


CDC-reserved 


01 


LO density (200 bpi) 


CDC-reserved 


—10 


HY density (800 bpi) 


HD density (800 bpi) 


11 


CDC-reserved 


PE density (1600 bpi) 


—00— 


Unlabeled 


Unlabeled 


—01 — 


U- or Z-labeled 


U- or Z-labeled 


—10— 


Y-labeled 


Y-labeled 


— 11 — 


CDC-reserved 


CDC-reserved 


00 


SCOPE data format 


SCOPE data format 


01 


CDC-reserved 


CDC-reserved 


10 


S tape 


Stape 


11 


Ltape 


Ltape 
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FILE NAME TABLE 



ENTRY AND OPTIONAL SUPPLEMENT 
FOR FILE IN INPUT QUEUE 



59 



53 50 47 



23 18 



C.FNAME 



C.FLINK 



Job Name 



C.FTAPE/C.FNT 

MT NT 

Count I Count 



C.FCPU 
C.FABT , 
C.FRRN| ,| 



C.FFRBA 
First RBT 
Word Pair 



C.FTL 

Time Limit 



L— Jo 



C.FiO 

Terminal ID 



f.FIOQ 
MST 



C.FDC 
Disposition Code 






Lock Bit 

Link Bit 
11 



0000 



C.FLNKAO 
Link to 
Supplement 



PFC Pointer 



C.FFL 
CMFL/100B 



C.FPRI 

Priority 



lob Card Error S.FJCEFT^Real Time Job 
*■ JANUS Pre-Abort S.FJABT 

No-rerun S.FRRN 

■ ' ■ ■ ■ in.-n i .nv . iM- . n-, 00 - CPU-A/CPU-B 

20 - CPU-A only 
40 - CPU-B only 
60 » Not this mainframe 



59 


53 


47 




35 


23 18 




*■*• 


Link Bit 

14 11 


0077B 


C.FBKLK 
Backward Link 


C.FIDENT 
Link ID 







0000 




C.FEQP * 
Device Type 


C.FFRBA * 
First RBT 
Word Pair 


C.FSID 

Source Station ID 


A 




C.FIOL 

I/O Time Limit 


S.FDPCT 
Depend. 
Count 


C.FOID 
Destination Station to. 


C.FECFL 
ECS 
FL/1000B 


C.FOPV 
Dependency ID 





•If non-zero, fields apply to pre-dayfile 
A - Keep bit 
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FILE NAME TABLE (CONT'D) 
TAPE FILE ENTRIES 

BEFORE EQUIPMENT ASSIGNMENT (GNT) 

59 47 



17 



■ Link Bit (bit 16) 
11 



C.FNAME C.FLINK / 

Logical Fib Neme Ul Control 


CFLNKAO 

Link to Optional 

Supplement 


C.FEQP , , 

-w 1 III 


I Volume Serial Number 


Allocation Style 




Word 2 from REQ Function Parameter List 




l—VSN Valid 
* — - GNT Word 3 Filled in from REQ Parameter Lift 
— Label Address in Control Point Area W.CPOAE 
Awaiting Tape Assignment 





SUPPLEMENT(S) IF MORE THAN ONE VSN GIVEN 



S3 




«7 


Multi-Reel File VSNs-| 
Alternate VSNs-i 
35 21 1 




17 


— Link Bit 

—Control Point Number 
15 11 


0077, 


C.FBKLK 
Backward Link 









1 






CFLNKAO 

Link to Optional 

Supplement 


0000 


Volume Serial Number 


0000 


0000 


Volume Serial Number 


0000 



SUPPLEMENT IF 2MT/2NT DECLARED 



so 


«7 


2MT/2NT Supplement - 
35 23 19 


15 


—Control Point Number 
11 


0077, 


C.FBKLK 
Backward Link 


1 


1 




0000 


C.FEQP 

Device Type 


C.FTPORD 
T.TAPES Ordinal 


EST Ordinal 


77 


77 8 


7777, 
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FILE NAME TABLE (CONT'D) 

TAPE FILE ENTRY DURING PROCESSING 



68 



S3 



47 



36 



23 



17 



l— Link Bit 

("•ontrol Point Number 

11 



C.FNAME 



Logical File Name 1 " 



C.FLINK 
.FCPNUM 



C.FLNKAD 
Link to FNT 
Supplement 



C.FEQP 
C.OEVTP 

Device Type 



CFTPOflO 
T.TAPES Ordinal 



C.FPD6V 

Primary EST 

Ordinal 



C.FCPRU 
CFLBt 

Current PRU Count 



C.FFETAD 

PET Address 



C.FDC 

Disposition Code 



C.FSC 



n: 



t 



Code and Status 



Conversion Mode (NT) 10 - US, 01 » EB 
l~ IB (inhibit System Nairn Brackets when 

IP.NBRK - 0) 
— Z Labels 

—— NR (No Error Recovery) 
— NS (Nonstandard Labels) 



E/N Bit 
FNT Write Bit 
READ Permission 
MODIFY Permission** 
EXTEND Permission 
CONTROL Permission 



ttt 



tMulti-file name if multi-file set after assignment and before first POSMF. 
ttNORING is not specified, 
ttt Expired tape label or operator override on unexpired tape label. 



60306500 H 



II-1-41 \ 



FILE NAME TABLE (CONT'D) 
ENTRY FOR LOCAL RMS FILE 
BEFORE ASSIGNMENT TO A DEVICE 



59 



S3 



LockBit-] I r~ 



47 



23 



Link Bit 

i— Control 
I Pt.No. 

17 11 



C.FNAME 



Logical File Name 



CFCPNUM C.FLINK 



C.FEQP MST 
Device 



Type 



Ordinal 



00 







tMtffcV 



.-^T.Qri'wL— 



10 



0077 



Permission Bits 
Index Write Bit . 



Back Link 



CFIDENT 
0301 



VSN 



(Reserved) 



CFLNKAD 

Link to 
Supplement 



CFALLOC 
-,„ (Allocation 
^ \ Style 



j 00 « No ECS Use 
1 10 - ECS Use; Supplement 
Required 



Link 



(Reserved) 



10 
11 9876 



CFALLOC 

Ftoos 



I 



Deferred Assignment 
System device 
ECS Buffered 
Queue device 
Overflow Allowed 
PF Device 
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FILE NAME TABLE (CONT'D) 

AFTER ASSIGNMENT TO A DEVICE AND THROUGHOUT PROCESSING 



59 



53 



47 



35 



Lock Bit 



23 



1 

17 



■ Link Bit 

•Control 
Pt. No. 



11 



C.FNAME 



Logical File Name 



C.FLNKAD/C.FAPF 

Link or 

APF Pointer 



C.FEQP 
Device 
Type 



t 



MST 
rdinal 



C.FFRBA 

First RBT Word 

Pair 



C.FLRBWP 

Current RBT 

Word Pair 



C.FCB 



ICurr. 
IByte 



C.FLPRU 
Current PR U 



CFFETAD 



FET Address 



C.FDC 
Disposition Code 



C.FECS/ 
C.FPFREW 



I 



Mil 



I 



Code and Status 



Control Permission 

Modify Permission —> 

Extend Permission 

Read Permission 

FNT Write Bit 



PF Rewrite Bit 
• Do not release RBT chain 

I 00 = No ECS Use 
' I 10 = ECS Use; Supplement 

Required 
•Sequential Pack E/N Bit, or 

Index Write Bit 



OPTIONAL SUPPLEMENTS FOR LOCAL RMS FILES 

FILE ROUTING SUPPLEMENT 



59 



47 



35 



23 17 



11 



7 7B 


C.FBKLK 
Backward Link 


C.FIDENT 
Link ID 




C.FLNKAD 
C.FAPF 


Source ID 


Destination ID 


Terminal ID 


Forms Code 


File ID for Output Queue 






Priority 



Priority Flag 



INTERCOM-USER FILE SUPPLEMENT (Required only when file to be attached to swapped-out job) 



59 



47 41 



35 



23 



-C.FMUJC MUJCode 

-Control Pt. No. 
17/11 



* 



7 7, 



8 



C.FBKLK 
Backward Link 



C.FIDENT 
Link ID 



00 



C.FAPF 
APF Pointer 



User Table Address 



C.FLOCID 
INTERCOM ID 



60306500 H 
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FILE NAME TABLE (CONT'D) 

ECS FILE SUPPLEMENT (ECS resident files or 10 buffers) 



59 53 


47 


35 


23 17 


f 


■Control Pt. No. 
11 


00 7 7 8 


C.FBKLK 
Backward Link 


(Reserved for 

Deferred 

Special DISPOSE) 


00 


C.FAPF 
APF Pointer 


Current 

Sub page 

Index 


Address of First Subpage 


Address of Current Subpage 






Backspace Count (ECS Overflow 
While Transferring from RMS to ECS) 



Word 1 Bit 54 Outstanding PPCIO Request Word 2 Bit 55 Release ECS Buffer 



55 ECS ("reallocation Flag 

56 1 ■ Release Bit 

57 » Output Buffer 
1 = Input Buffer 

58 Buffer Overflow 

59 1 - ECS-Buffered File 



After the Current SR 
56 Index Written (Close Random File 
59 Transfer in Progress (ECS 

Resident Random Files) 



ECS FILE SUPPLEMENT (ECS Resident Library) 



59 



53 



47 



35 



23 



17 



11 



007 7B 


C.FBKLK 
Backward Link 


(Reserved for 

Deferred 

Special DISPOSE) 





Con- 
trol 
Pt. No. 




EOl 
Index 


Address of First Subpage 


Address of EOl Subpage 


Current 
Index 


Addr. First Auxiliary Subpage 


Address Current Subpage 



Word 1 Bit 55 ECS Prea I location Flag 
56 1 = Release Bit 
59 1 = ECS Buffered File 



Word 2 Bit 59 Transfer in Progress 



| IM-44 
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FILE NAME TABLE (CONT'D) 
DEVICE SET ENTRY 

One entry for each device set each job has mounted. 

59 47 35 

W.FSN 

W.FVSN 

W.FORD 

A = 1 set name flag (S.FSET) 



23 



17 15 11 



A 


C.FNAME C.FCP 
Device Set Name 








C.FMST 
MST Ordinal 




C.FVSN 

Master Device VSN 








C.FEST 

EST ordinal of 

master device 







60306500 J 
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ENTRIES AND REQUIRED SUPPLEMENT FOR FILES 
IN OUTPUT QUEUES DURING PROCESSING 



59 



53 



47 



35 



23 



18 



C.FNAME 



Job Name 



C.FEQP 

Device Type 



C.FFRBA 
First RBT 
Word Pair 



CFFETAD 



Line Count 



C.FLRBWP 
Current RBT 
Word Pair 



C.FDC 
Disposition Code 



C.FCB 



Link Bit 
, — JANUS Control Pt. No. 

16 11 



Curr 
Byte 



CFLNKAD 

Link to 
Supplement 



C.FLPRU 
Current PRU 



(See Local 
RMS File) t 



C.FCS 
Code and Status 



59 



47 



7 7B 



C.FSCT 

Sector 
Count/1 OOB 



35 



23 18 



11 



C.FBKLK 
Backward Link 



C.FFRBA 
First RBT 
Word Pair 



C.FRPT 
C.FDID 

I 



t 



Destination ID 



CFIDENT 
Link ID 
102 



C.FID 

Terminal ID 



C.FDC 
Disposition Code 



00 



C.FIOQ 
MST 



0B 



PFC Pointer 



C.FFC 

Forms Code 



C.FPRI 

Priority 



Repeet Count 
-Dayfile Last Record of File 

A = 1 if 8 lines per inch specified (S.F8LPI) 

B = 1 if automatic page eject specified (S.FAUTO) 

C = 1 if link FST1-FST2 contains information related to file routing 

ENTRIES AND OPTIONAL SUPPLEMENT FOR FILES 
IN OUTPUT QUEUES 



59 



47 



23 



18 



C.FNAME 



Job Name 



C.FSCT 

Sector 
Count/100B 



C.FFRBA 
First RBT 
Word Pair 



C.FRPT 
C.FDID 

Mr 



t 



Destination ID 



C.FID 

Terminal ID 



C.FDC 
Disposition Code 



C.FIOQ 
MST 



Lock Bit 
Link Bit 



I— Link I 



CFLNKAD 
Link to 
Supplement 



PFC Pointer 



C.FFC 

Forms Code 



C.FPRI 

Priority 



Repeat Count 
Dayfile Last Record of File 



59 



47 



7 7B 



C.FEQP 

Device Type 



CFFETAD 



35 



23 18 



C.FBKLK 
Backward Link 



C.FFRBA 
First RBT 
Word Pair 



Line Count 



CFIDENT 
Link ID 
103 



C.FLRBWP 
Current RBT 
Word Pair 



C.FDC 
Disposition Code 



00 



C.FCB 



Lock Bit 
r- Link Bit 
15 11 



Curr 
Byte 



(See Local 
RMS File) t 



0000 



C.FLPRU 
Current PRU 



C.FCS 
Code and Status 



A = 1 if 8 lines per inch specified (S.F8LPI) 

B = 1 if automatic page eject specified (S.FAUTO) 

Supplement will be present if file processing has been interrupted by abort or deadstart recovery. 
NOTE: File is not rewound. 



11-146 
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FILE NAME TABLE (CON'T) 

MMF PACKET FILE ENTRIES 

ENTRY AND REQUIRED SUPPLEMENT FOR FILE BEFORE OPEN (GETPF) 





entry and required supplement 
for file before open (GETPF) 








— — lock bit 
— link bit 






C.FNAME 

File Name 


Con- 
trol 
Point 


C.FLNKAD 

Link to 
Supplement 








C.FEQP 

■ MST 
27B 1 Ordinal 


C.FFR8A 

1st RBT 
Word Pair 


C.FLRBWP 

Current 
RBT Word Pair 


C.FCB 

Current Current 
DAM Ordinal | Byte 


C.FLPRU 

Current 
PRU 




Reserved 







C.FPKTYP 
Packet Type 


C.FCS 

Code and i i 
Status IS C 










i lock bit 










— link bit 




00778 


C.FBKLK 

Backward Link 


0500B 




Con- 
trol 
Point 


0000 














E J 


Job Descriptor 
Table Ordinal 




Logical ID (ST) 
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FILE NAME TABLE (CONT'D) 

ENTRY AND REQUIRED SUPPLEMENT AT CONTROL POINT ZERO AFTER OPEN (C.ETPF) 





entry and required supplement 

at control point zero alter open (GETPF) 






— lock bit 
— link hit 






C.FNAME 

File Name 


0000 


C.FLNKAO 

Link to 
Supplement 








C.FEQP 

| MST 
27B J f>dinal 


C.FFRBA 

1st RBT 
Word Pair 


C.FLRBWP 

Current 
RBT Word Pair 


C.FCB 

1 Current 
I Byte 


C.FLPRU 

Current 
PRU 




Reserved 


* 


0000 


C.FRKTYP 

Packet Type 


C.FCS 

Code and l l 
Status |s|C 












lock bit 

—link bit 














0077B 


C.FBKLK 

Backward Link 


0S0OB 







0000 


J 














C.FFETAO 

■ i FET Address 

E l 1 


Job Descriptor 
Table Ordinal 




Logical ID (ST) 





II-I-48 



60306500 F 



FILE NAME TABLE (CONT'D) 

ENTRY AND REQUIRED SUPPLEMENT FOR FILE AT CONTROL POINT ZERO AFTER COPY HAS 
BEEN STAGED (GETPF) 





irntry and tequired supplement for file at 
control point zero after copy has been staged 
(GETPF) 






r 


— lock bit 
—link bit 






C.FIMAME 

File Name 


i 





C.FLNKAD 

Link to 
Supplement 








C.FEQP 

■ MST 
27 B Ordinal 


C.FFRBA 

tst RBT 
Word Pair 


C.FLRBWP 

Current 
R8T Word Pair 


C.FCB 

Current Current 
DAM Ordinal I Byte 


C.FLPRU 

Current 
PRU 




Reserved 




0000 


C.FPKTYP 

Packet Type 


C.FCS 

Code and t ■ 
Status Isle 
















r— link bit 






0077 B 


C.F8KLK 

Backward Link 


05008 




It 





00 00 








• 


C.FEQP 
Device ■ MST 
Type Ordinal 


C.FFRBA 

1st RBT 
WOrd Pair 


C.FLRBWP 

Current 
RBT Word Pair 


C.FLB 

Current Current 
DAM Ordinal j Byte 


C.FLPRU 

Current 
PRU 






C.FFETAD 

i 1 FET Address 
E J J 


Job Descriptor 
Table Ordinal 




Logical ID <ST) 





'Actual file information is in word 1 of the supplement 
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FILE NAME TABLE (CONT'D) 

ENTRY AND REQUIRED SUPPLEMENT FOR FILE AT CONTROL POINT ZERO (SAVEPF) 















lock bit 

i— link bit 






C.FNAME 


File Name 






1 




C.FLNKAD 

Link to 
Supplement 








C.FEQP 

i MST 
27 B 1 Ordinal 


C.FFRBA 

1st RBT 
Word Pair 


C.FLRBWP 

Current 
RBT Word Pair 


C.FCB 

Current Current 
DAM Ordinal I Byte 


C.FLPRU 

Current 
PRU 




0000 


C.FPKTYP 

Packet Type 


C.FCS 

Code and 1 1 
Status |s|C 












?— lock bit 












r— link bit 
1 




0077B 


C.FBKLK 

Backward Link 


0500b 







000 






• 


C.FEQP 
Device ■ MST 
Type 1 Ordinal 


C.FFRBA 

1st RBT 
Word Pair 


C.FLRBWP 

Current 
RBT Word Pair 


C.FCB 

Current Current 
DAM Ordinal] Byte 


C.FLPRU 

Current 
PRU 






C.FFETAD 

1 " 


: .T Address 


Job Descriptor 
Table Ordinal 




Logical ID (ST) 





'Actual file information is in word 1 of the supplement 
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FILE NAME TABLE (CONT'D) 

ENTRY AND REQUIRED SUPPLEMLNT FOR FILE AT CONTROL POINT ZERO (PURGE) 















— lock bit 
p— link bit 

1 






C.FNAME 


File Name 





C T FLNKAO 

Link to 
Supplement 










C.FEQP 

1 MST 
278 Ordinal 


C.FFRBA 

1st RBT 
Word Pair 


C.FLRBWP 

Current 
RBT Word Pair 


C.FCB 

Current Current 
DAM Ordinal 1 Byte 


C.FLPRU 

Current 
PRU 




0000 


C.FPKTYP 

Packet type 


C.FCS 
Code & Status ■ . 
























IOCK OH 

r— link bit 




007 7 B 


C.FBKUC 

Backward Link 


50 B 




1 




0000 




















Job Description 
Table Ordinal 




Logical 10 1ST) 





C — complete bit 

E - the EC flag saved from the user 'FOB 

S - Packet status bit 



PACKET Type codes are: 



0100 B ATTACH 
0200 B CATALOG 
0300 B PURGE 
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DISPOSITION CODE VALUES (C.FDC) 
Non-Allocatable Devices 



CK 


XXX 1 


Checkpoint 


IU 


xxx2 


Inhibit unload 


CI 


xxx3 


Checkpoint and inhibit unload 


sv 


xxx4 


Save 


cs 


xxxS 


Checkpoint and save 




xxx6-7777 


Reserved 



Allocatable Devices 

For allocatable devices, the byte C.FDC is divided into four fields: 



11 



9 7 



EC 


T 
1 
D 


IC 


Disposition 
Code 



Code 



Value 



EC (Bits 11-9) External Code 
(Print/Punch) 



Default 


000 


- - /EC=SB 


001 


EC=A4/EC=80 column 010 


EC=B4/ - - 


011 


EC=B6/EC=026 


100 


EC=A6/EC=029 


101 


EC=A9/EC=ASCII 


no 


.. /.. 


in 



Description 



Default print train/Default punch character set 

Reserved/Punch SCOPE binary 

ASCII 48-character print train/Punch 80-column binary 

BCD 48-character print train 

BCD 64- character print train/Punch 026 

ASCII 64- character print train/Punch 029 

ASCII 96-character print train/Punch ASCII 

Reserved for installations 



T1D (Bit 8) Terminal Identification 
Relevant only for local files, not queue files. 



TID=xy 

TID=C 1 

xy = terminal identification 



Route file to remote user 
Ignore remote ID in file routing 



11-1-52 
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DISPOSITION CODE VALUES (C.FDC) (CONT'D) 
Code Value Description 

IC (Bits 7-6) Internal Code 



IC=*DIS 




00 


File format is display code 


K>ASCII 




01 


File format is ASCII 


IC=BIN 




10 


File format is binary 


f - 




11 


Reserved 


Disposition 


Code (Bits S-0) 








01 


Reserved 






02 


Reserved 






03 


Reserved 






04 


Input job ready for scheduling 






05 


Input tape job 






06 


Input tape job on VSN display 






07 


Reserved 


PU, PB or 


P8 


10 


Punch, EO80, SB, 026 or 029 


FRt 




20 


Film print 






•21 


Reserved 


FL+ 




22 


Film plot 






23 


Reserved 


HRt 




24 


Hard copy print 






25 


Reserved 


HLt 




26 


Hard copy plot 






27 


Reserved 


Pit 




30 


plot 






31-37 


Reserved 


PR 




40 


Any available printer 


PI 




41 


Any available 501, 505, only BOM or B6 are valid 


P2 




42 


Any available 512, only EC=B4, B6, A6 or A9 are valid 


LR 




43 


Any available 580-12, only EC=B4, B6, A4, A6, or AS* are valid 


LS 




44 


Any available 580-16, only EC=B4, B6, A4, A6, or A9 are valid 


LT 




45 


Any available 580-20, only EOB4, B6, A4, A6, or A9 are valid 






46-65 


Reserved for CDC 






66 


System dynamic dump file 






67 


Reserved for CDC 






70-77 


Reserved for installations 



fRecogjrized but not supported by SCOPE 3.4. 
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LINK IDENTIFICATION VALUES (C.FIDENT) 



Value 

00OOB 

OlOOB 

0101B 

0102B 

0103B 

0104B1 

0177B J 

02008 

0201 B 

02O2B 

0203B1 

0277B( 

0300B 

0301B 

0302B \ 

0377B I 

0400B 

0401B 

0402B 

0403B 

0404B* 

0477B J 

0500B \ 

0577B / 

0600B 

0601B 

0602B 

0603B- 

0677B. 

0700B 

0701 B 

0702B- 

6777B 

7000B- 

7777B 



Description 

Reserved for CDC 

Input queue link 

Input queue during processing link 

Output queue during processing link 

Output queue file interrupted by deadstart recovery or ABORT 

Reserved for CDC 

Tape with alternate VSNs link 
Tape with multiple VSNs link 
Tape with 2MT(NT) link 

Reserved for CDC 

Permanent pack link 

Disk VSN for file assignment 

Reserved for CDC 

Editor file during processing link 
File to be replaced link 
File to be deleted link 
SPOT dayffie link 

Reserved for CDC 

Reserved for CDC 

Routing information link 
Reserved for CDC 

System dynamic dump file link 
Reserved for CDC 

Reserved for ECS resident file or I/O buffered file link 
Reserved for ECS resident library link 
Reserved for CDC 

Reserved for Installations 



IM-54 
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INTERCOM MULTIPLEXER TABLE 



59 



W.IUSID 
W.ICOM 



W.IENDLS 
W.I DEBUG 



47 



41 



35 



23 



11 



C.ITUSID 
Last User ID 
Assigned 



C.ILSFL 
(LWA+D/100B 
of Small Buffers 



C.1 1 BR 

Drop Flags 



C.IFBUFR 
00 | 



C.IUPF 

Up Flags 



FWA of 
Small Buffers 



CINTDSD 
DSD Flags 



C.I1LX 

1LX Flags 



CIDEBUG 

Driver Debug Flags 



Multiplexer Subtables 
(One Subtable per MUX) 



2 



NOTES: INTERCOM MULTIPLEXER TABLE 

W.ICOM(0) C.I1BR(1) Multiplexer Table Header - Communications 

Bit S.IEDIT EDITLIB active 

1 SJ1H HI initialization active 

2 S.I1BR 1BR drop flag 

3 S.IDI Driver-initializer active 



W.ICOM(0) 

Bit 5 
6 



C.IUPF(2) 

S.I1CI 

S.IDD 



1CI up 
Driver up 



W.ICOM(0) 




CJNTDSD(3) 


Bit 





S.INTDRP 




1 


S.INRST 




4 


S.ILKOUT 




5 


S.I1CI 




6 


S.IDD 



W.ICOM(0) 



C.I1LX(4) 



INTERCOM drop requested flag 
Restart in progress 
LOGIN Locked out 
1CI drop requested 
Driver/ 1LX drop requested 

Two bit count of active iLXs for each driver 
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6671 MULTIPLEXER SUBTABLE 



59 



53 



47 



35 



27 23 



11 



C.IOTFL 

Count of 

Output Failures 



C.ILSDT 
Count of Lost 
Data Failures 



C.IMPAR 

Count of MUX 

Memory Parity Store 



C.ITIO 

First 
Terminal 10 



C.INPTS 

Number of 

ports serviced 



t 



Port Entries 



J 



6676 MULTIPLEXER SUBTABLE 



59 



53 



47 



35 



C.IOTFL 

Count of 

Output Failures 



C.ILSDT 
Count of Lost 
Data Failures 



23 



Port Entry (One for Whole MUX) 



11 



C.INPTS 

Number of 

Ports Serviced 



6673/6674 MULTIPLEXER SUBTABLE 



59 47 




35 


23 


11 


C.IGCON 

Graphics Console 
Configuration 


C.IHCON 

Multiplexor 
Configuration 


C.ITID 

First Terminal 
ID 




Port Entry (one for whole MUX) 



Byte C.IGCON 24 bits representing 24 possible consoles (00 to 36) from left to right. 
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LCC MULTIPLEXER SUBTABLE 



59 



53 



47 



35 



29 



23 



1 1 



CJLCST 

C.ILfclLST 
LCC 

State 



FWA of CSM line 
list for this LCC 



CINRPS 

CIRPLST 
No. 

entries 



CIRPl 
fi ° w I 



FWA of CSM 
response list entries 



= 8K LCC/ 
1-4KLCCl^ 



-1 



C.ITID 

First Terminal 
10 



C.INPTS 

Number of 
Ports 



I 



Port Entries 



J 



2550 NPU MULTIPLEXER SUBTABLE 

59 53 



35 



C.IMCNT 



t 



Connection Tabic 
I FWA 



27 23 



T1 



C ' M c E T ST ||,Pseudo 
Or*LJ?[ EST 



C.ITI0 


D 

T 


C.INPTS 


irst Terminal 


Highest Port 


ID 


No. + 1 



Port (Must be empty) 



Port* 1-N 



1 



C.IMCNT 

Bits 



05-00 Upper 6 bits of Connection Table FWA 



C.IMCNT+1 

Bits 



11-00 



Lower 12 bits of Connection Table FWA 



CIMEST. 
Bits 



CITID 

Bits 

C.INPTS 

Bits 



11-06 EST Ordinal 

05 Reserved 

04 Request-to-Stop-NPU-Service Bit 

03-00 Pseudo EST 

11-00 First terminal ID 

08-00 Highest port number + 1. The line entry for port must be empty. A 

communication line must not be connected to port 0, 
10-9 Reserved 

S IBDMP 

Bit 11 Dump type: means display code dump; 1, binary dump 

SUBTABLE PORT ENTRY 



59 



53 



47 



35 



23 



11 



C.ILNST 

C - INBUF . FWA of First 
St'a« J UserTable 


C.IBMAP 

Site 
Configuration 


CISTATN 
C.IBMAP+1 

Station 
Configuration 


CIPRO 

Terminal 
Type 
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Bit map of streams configured by 73x-10. Replaces site and station address for these terminals. 



C.IBMAP+1(3) 










Bit 


Unused 








1 


Stream 





Configured 


(IDS output) 


2 


Stream 


2 


Configured 


(CRT) 


3 


Stream 


8 


Configured 


(CP1) 


4 


Stream 


12 


Configured 


(LP4) 


5 


Stream 


10 


Configured 


(LP3) 


6 


Stream 


6 


Configured 


(LP2) 


7 


Stream 


4 


Configured 


OP1) 


8-15 


Unused 








16 


Stream 


1 


Configured 


(IDS input) 


17 


Stream 


3 


Configured 


(KBD) 


18 


Stream 


7 


Configured 


(CR2) 


19 


Stream 


5 


Configured 


(CR1) 


20-22 


Unused 









S.ILNOFF 

Bit 11 



S.ILT 



Bit 



10 



S.ILS 



Bits 9-07 



CIPRO 

11 10 9 8 7 6 S 4 3 2 1 



S.ILNOFF 
S.ILT 

S.ILS 

S.ICHCD 






L 



S.IPRO 

S.ISPRO 
S.ICHCO 



Line offed ■ on 
■1 off 



Line type - Dial-up 

= 1 Hard-wired 



line speed * 110 BPS 

•■I 134.5 BPS 
= 2 150 BPS 
- 3 300 BPS 
= 4 2000/2400 BPS 
= 5 4800 BPS 
= 6 9600 BPS 
= 7 19.2 UP KB 
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S.ICHCD Character Conversion = ASCII 

= 1 External BCD 

= 2 Display Code 

S.ISPRO Subprotocol 

If mode 4 terminal = 1 Mode 4A 

= 2 Mode4C 

If wideband terminal = 1 Batch only 

= 2 Interactive 



S.IPRO 



Protocol field 



= Empty 

= 1 Mode 3 

= 2 Mode 4 

= 3 Mode 2 

= 4 Wideband 



DEVICE ACTIVITY TABLE ENTRY 



W.DATSTA 



W.DATSUM 



W.DATIL* 



59 57 


M 41 


35 


23 


11 


X 
Y 


C.DATDST 

DST 

Ordinal 


C.DATEQP 
C . Eqp. 
I Type 


C.DATACT 
Activity 




Count 

Maintained 

BySPM 




CDATNFC 

New File 

Count 


C.DATPRU 

PRU 

Weight 


C.DATWAT 
1SP 


C.DATSR 

Stack Req. 

Weight 


C.DATACT 

Controller 
Activity 


CDATNFC 

Pre. Newfile 

Count 


C.DATPRU 

Previous PRU 

Count/1 OB 


CDATWAT 

Previous 

(Bypass Count) 


C.DATSR 

Previous 

S.R. Count 


Set By SPM 


SetByISP 


1/L 
Address 


Member ID+1 


DDT Ord 


EST Ord 


l/L Broken If 
=£0 (EST) 



X = Controller on = 0, off = 1 

Y = Controller autoloaded, yes=0, no=1 

* W.DATIL can be cleared only by 1SP 



C = 1 = Shared controller (used only by Deadstart) 



DUMMY ENTRY FOR DUAL ACCESS DEVICE 

59 57 47 35 



23 



11 



X 
Y 





(Reserved) 


(Reserved) 


(Reserved) 


(Reserved) 








(Reserved) 






(Reserved) 


(Reserved) 
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TAPES STAGING TABLE 



59 C.STGMT 47 C.STGNT 35 



23 



11 



W.STGMAX 



W.STGFRE 



W.STGUFD 



W.STGSAT 



W.STGTLE 



W.STGTLR 



W.STGTLT 



Number of 
MT Defined 


Number of 
NT Defined 


(Reserved) 


(Reserved) 


(Reserved) 


Number of 

MT ON and 

U reassigned 


Number of 
NT ON and 
Unassigned 














Unfilled 
MT Demand 


Unfilled 
NT Demand 














Number of MT 

Held by 
Satisfied Jobs 


Number of NT 

Held by 
Satisfied Jobs 














No Tape 
Status Flag 


(unused) 


Useless information from T.MSC 


Copy of T.MSC 



















(Total) 



(Available) 



(Unfilled 
Demand) 



(Assigned) 



ATTACHED PERMANENT FILE TABLE 



59 



47 



35 



C.PFD1 



C.PFRBT 
First RBTA 



23 



17 



C.PFD2 
— PFD Pointer 



C.PFD3 



C.PFCNT2 
Count 2 



C.PFCNT 
Count 1 



C.PFD4 

1* 



C.PFQ* 
PFQ Address 



C.PFCY 
Cycle No. 



C.PFLAG 
Flag Byte 



,r11 10 9- 8 7 6 5 4 3 2 1 Oir 



Archived PF 

from 

6000 to 7000 

(Reserved) 

System PF 

Obsolete FRBT 

Archive 

File attached 
on another 
mainframe 



H 



Word 1 



Word 2 



t 



Priority lockout/Empty entry reserved 

Single write 

Single modify 

Exclusive access 

RB conflict 

Interlock 



*lf ¥= 0, PFQ Address = JDT Address of a job waiting for permanent file. 
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REQUEST STACK ENTRY 

59 47 



38 35 



23 21 17 



11 



No FNTh 

First 
Word 

Direct ■*•* 



FNT- 



OSTPRBA 
RBT Address 



RB Number 



0000 



CSTPRBN 
RBT Index 



RB 
Byts 



EST Ordinal 



FST Address 



CSTPPRU 



PRU Number 



0000 



•Read 844-21 or 844-41 
Factory Format Data 
According to PRU 
Number Value: 
PRU*0 Read Pack Serial Number 
=1 Read Factory Flaw Map 
=2 Read Utility Flaw Map 



1-Direet Access 
For Reading/ 
Writing MS. 
Label 



J 



C5T0 
DB 
Rec. 
Level 



Order 
Code 



C.STCPU 



CTL 
PT 



Request 
Stack 
Chain 
Link 



•— SPM Recall 
l ~ Interlocked Stack Request 
• Do Not Check Buffer in FL 



59 



47 



41 



35 



23 



PP 

Second 
Word 



CM 



ECS (2=1) 



C.STPWC 



C.STPMS 
PP Message 
Byte Address 



FWAOf FST Or 
Reply Word Address 



C.STPFW 
FWA in 
PP Core 



FWA In CM Or 
Count For Skips 



Plffl 



rar 



Reply Word » 1 
FET -0 



47 



1=SR Linked To - 
Beginning Of 
Proper DST 

Release (Read Or Skip) '• 
Or Write EOF 

35 






17 



11 



C.STPLW 
LWAin 
PPCore 



LWA+2 In CM For Write 
LWA+3 In CM For Read 



LIMIT If FET Exists 



23 



1 = File Mas ECS Buffer 

Exact (Don't Read Ahead) 
1 - No FET 

1 - No FNT 

1t 



EOI PRU 


FST Address 


First RB Number 
Of RBR 


PRU/RBOf 
This RBR 


RBR Number 



Third 
Word 



(Supplied by SPM) Note: SPM converts FNT format into no-FNT format but does not change the no-FNT bit. 



STACK PROCESSOR ORDER COOES 

00 O.READ Read into central memory 

01 O.RDSK Readskip into central memory 

02 O.RCMPR Read into central memory, drop first 

3 CM words 

03 O.RDNS Read non-stop 

04 O.WRT Write from central memory 

05 O.WRTR Write EOF/EOR from central memory 

06 O.RMR Read multiple records to central memory 
07 

10 O.RDP Read into PPU memory 

11 0-RDPNP Read into PPU, drop first 3 CM words 

12 O-SKF 1 " Skip forward 



13 


O.SKB 1, 


14 


O.WRP 


15 


O.WRPR 


16 


O.BPRU f 


17 


O.RCHN? 


20 


O.RCTNU 


2-* 


O.WCTNU 


35 


O.IDLE 


36 


O.DROP 


37 


O.SEEK 



Skip backward 
Write from PPU memory 
Write EOF/EOR from PPU memory 
Backspace PR U 
Evict 

Read nonstop (comparable to tape 
READN) 

Write nonstop (comparable to tape 
WRITEN) 

Wait for stack request 
Drop PP 
Issue overlap seeks 



^Setting or not setting the interlock stack request bit has no affect on the interlock. 
60306500 K 
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REQUEST SCHEDULING TABLE 

Used to schedule stack requests in the request stack (T.RQS). 

- Header 



Entry 



S ■ status 



59 




47 


35 




23 


11 


1SP Drop 
Request Flag 








SR Entry 
Count 


Empty Chain 


59 50 47 


35 




11 


DDT Ordinal 


S 


PB Number 


SPM War king Scratch 


Link 



RECORD BLOCK RESERVATION TABLE 



W.RBRTPA 
W.RBRUNT 

W.RBRLAV 



T.RBR 53 



47 



41 



35 



23 21 19 



C.RBRTPA 
Device 
Type 1 ' 



Length/2 
Bit Table 



CRBRUNT 
DST 

Ordinal 



Unit 



RBR Bit Table 
Starting Address 



Starting 
Device Address 



C. RBR EST 
EST Ordinal 



11 



C.RBRAL 

Allocation 

Style 



C.RBRLAV 

Available RBs 

In CM 



Any Additional Header Word Pairs 



PRU/RB 



Available 
In DAM™ 



T.RBRBIT 



Length 



Bit Table Starting Address Pointed To By Header Word 



A Overflow flag 

f Device type codes are the same as those used for the Equipment Status Table 

tt During deadstart this byte contains total number of RBs. This field is only updated 
when DAM is referenced. 
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DEVICE STATUS TABLE (MASTER ENTRY) 

Device Status Table entries are numbered, starting from 1, to identify DST ordinals. 



59 


47 


41 


35 31 




29 


23 


20 


17 


11 


Channel Time 
Accounting Factor 


Reserved 


Reserved 
For 
Inst. 


Res. 


W 


M 


N 


Start Of 
Chain Pointer 


1S 


P*0 


Driver 
Name 


DST 
Ordinal 


E 


S 


Channel 


Nonzero If a PP 
Is Assigned 



*1S5 for DST ordinal one. 
Second word used for PPI R. 

W 1SP working flag (when 1SP is active) 
= 1SP idle 

5 = Stack request ordinal S assigned 
M Member number (0 for master entry) 
N Number of member DST entries 

S Scheduling options 
0= FIFO 
4 = Selection only 

6 = Overlap seek and selection 
E Equipment 

Driver Name A display code letter which is added to the characters 3S to form the overlay name 

Valid letters are 
W 841 Disk Pack 
Y 844 Disk Pack 



DST MULTIPLE ACCESS MEMBER ENTRIES 

DST entries for dual access to a set of mass storage units. 



59 


47 


41 


35 31 




29 


23 


20 


17 


11 c 


Channel Time 
Accounting Factor 


Reserved 


Reserved 
For 
Inst. 


Res. 


W 


M 





Nonzero If Work 
Is Available 


1S 


PO 


Driver 
Name 


DST 
Ordinal 


E 


* 


Channel 


Nonzero If a PP 
Is Assigned 



Second word used for PPIR. 

M Member number (1-3) 
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SEQUENCER TABLE 

59 
T.SEQ 

APR PAIR { 

+ 1 
+2 
1st JOB PAIR < 

+3 



Nth JOB PAIR \ 



+L.SEQ-1 




A = Maximum number of job entries (L.SEQ-2/2) 
B = Number of jobs in Sequencer Table 
C = On/Off/Drop Flag 

0-Off 

1-0n 

2-Drop 
D = Table Interlock Flag 
E= Entry Full Flag 
F = Diagnostic Flag Bits 

Bit = CT3 

Bit 1 =MY1 

Bit 2 = CM6 

Bit3 = CU1 

Bit 4 = ALS 

Bit 5 = FST 

Bit 6 = EC2 

Bit7=ALX 

Bit8 = CEFAP 

Bit 9 = reserved 

Bit 10 = reserved 

Bit 11 = reserved 
G = Entry Drop Flag 
H = Interval 
I = Clock 
J = Job Name 
K = Last known FNT Address 
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OVERVIEW OF MOUNTED SET TABLE (MST) 

The Mounted Set Table follows the CMR Installation Area. 



One Entry for Each 
Mounted Set Including 
System Set 



Entry Size = 5 CM Words 
MOUNTED SET TABLE (MST) ENTRY 



W.MSVSN 



W.MSSN 



W.MSPTR 



W.MSPFC 



W.MSPFD 



59 


47 


35 


29 


23 


17 


11 


C.MSVSN 

Master Device VSN 


C.MSMFD 

Mainframe 

Ordinal 


C.PFMIL 

l kj|iIhJg|f|e|dJcJb|a 


C.MSSN C.MSPEOI 

+ Set Name . Reserved 


C.MSSMT 

Pointer to 
First RB of SMT 


C.MSRBR 

First RBT word 
pair ordinal of DAM 


C.MSEQT Master 
Dev. Equip. Type 

"^Max. Number 
Files/1 00B 


C.MSEST 

^Master Device 
EST Ordinal 


C.MSACT No. Active 
Jobs Accessing Set 
*+Maximum No. of 
Members 


C.MSPFC 

Primary PFC 
First RBT 
Word Pair 


C.MSPFC1 

Auxiliary PFC 
First RBT 
Word Pair 


C.MSPFCS 

PFC Size 
(inPRUs/lOB) 


C.MSCEOI 

M PFC Current EOI 
1 IPRU Offset) 


C.MSPFD 

Primary PFD 
First RBT 
Word Pair 


C.MSPFD1 

Auxiliary PFD 
First RBT 
Word Pair 


C.MSHPN 
C.MSHPS 
Number of 
Hash Points 


Hashing 

Left Shift 

Count 


Reserved 


Reserved 



A (reserved) 

B = PFM Interlock (S.MSPFMI) 
C = Utility Interlock (S.MSUTIL) 
D = Set Interlock (S.MSSETI) 
f E = System Set Bit (S.MSSYS) 
*F = PF Default Set (S.MSPF) 
*G = Queue Set (S.MS3) 



Set up by deadstart for post deadstart. 
*Not used by system after post deadstart. 



H = System Scratch Set (S.MSSCR) 
Jl = Deadstart Action (S.MSACT): 

00 Check 

01 Initialize 
10 Modify 

K = Reserved (S.MSBF) 
f L = RB Conflict (S.MSTRCF) 
M = Wrap-around Flag (S.PFCW) 
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OVERVIEW OF DEMOUNTABLE DEVICE TABLE (DDT) 

The dismountable device table follows the MST in CMR. 



Fixed 
Section 



Variable 
Section 



One Entry for 
Each RMS EST 



One Entry for Each 
Device Requested 
That is Not On-Line 



Entry Size = 2 CM Words for Variable Section 
= 4 CM Words for Fixed Section 



DDT ENTRY (FIXED SECTION) 



F=1 \ W.DDVSN 

Not Yet 

Mounted 

(Free) / W.DDSN 

On-line 



59 


47 


35 


23 


17 


11 





C.DDVSN 


I 

VSN 


I 


C.DDSTAT 


l|k|j|i|h|g 


M 




C.DDSN 


Set Name 









C.DDEST 
EST Ordinal 



F=0 

Mounted 
(Busy or 
Off-line) 





59 


47 


35 ; 


>3 


17 


11 




2 


W.DDVSN 


C.DDVSN 1 1 
VSN 


C.DDSTAT 

TTTrt 


l|k|j|i|h|g 


M 


SR 


S 


W.DDORD 


C.DDFRBR 
First Disk RBR 
(DAM) Ordinal 


C.DDLRBR 
Last Disk RBR 
(DAM) Ordinal 




C.DDMST 
MST Ordinal 


C.DDEST 
EST Ordinal 



C.DDSTAT (EST Status) 
A = Request Idle (S.DDIDLE) 
B = Busy (S.DDBUSY) 
C = Free(S.DDFREE) 
D = Off (S.DDOFF) 
E = Relabel during deadstart (S.DDR LB) 
F - SN bit; device not mounted if set 
(S.DDSN) 



G = System Device (S.DDSYS) 

H = PF Device (S.DDPF) 

I - Queue Device (S.DDQ) 

J = Master Device (S.DDMSTR) 

K = Preallocated (S.DDPRE) 

L = Reserved (S.DDBF) 

M = Overlap seek in progress 

S = Overlap seek status 

SR = Stack request ordinal assigned to unit 
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OVERVIEW OF MOUNTED SET TABLE (MST) 

The Mounted Set Table follows the CMR Installation Area. 



One Entry for Each 
Mounted Set Including 
System Set 



Entry Size = 5 CM Words 
MOUNTED SET TABLE (MST) ENTRY 



W.MSVSN 



W.MSSN 



W.MSPTR 



W.MSPFC 



W.MSPFD 



59 


*7 


35 


29 


23 


17 


11 











C.MSVSN 

Master Device VSN 


C.MSMFD 

Mainframe 

Ordinal 


C.PFMIL 
L K J i Hg|f[e|d|C 


B A 


C.MSSN C.MSPEOI 

"Set Name . Reserved 


C.MSSMT 

Pointer to 
First RB of SMT 


C.MSRBR 

First RBT word 
pair ordinal of DAM 


C.MSEQT Master 
Dev. Equip. Type 

*tMax. Number 
Files/1 00B 


C.MS EST 

'Master Device 
EST Ordinal 


C.MSACT No. Active 
Jobs Accessing Set 
""^Maximum No. of 
Members 


C.MSPFC 

Primary PFC 
First RBT 
Word Pair 


C.MSPFC1 

Auxiliary PFC 
First RBT 
Word Pair 


C.MSPFCS 

PFC Size 
(inPRUs/10B) 


C.MSCEOI 

M PFC Current EOl 
I IPRU Offset) 


C.MSPFD 

Primary PFD 
First RBT 
Word Pair 


C.MSPFD1 

Auxiliary PFD 
First RBT 
Word Pair 


C.MSHPN 
C.MSHPS 
Number of 
Hash Points 


Hashing 

Left Shift 

Count 


Reserved 


Reserved 



A (reserved) 

B - PFM Interlock (S.MSPFMI) 
C = Utility Interlock (S.MSUTIL) 
D = Set Interlock (S.MSSETI) 
+ E = System Bit (S.MSSYS) 
f F * PF Default Set (S.MSPF) 
t G = Queue Set (S.MSQ) 



Set up by deadstart for post deadstart. 
Not used by system after post deadstart. 



H = System Default Set (S.MSSCR) 
Jl = Deadstart Action (S.MSACT): 

00 Check 

01 Initialize 
10 Modify 

K = Reserved (S.MSBF) 
r L = RB Conflict (S.MSTRCF) 
M = Wrap-around Flag (S.PFCW) 
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OVERVIEW OF DISMOUNT ABLE DEVICE TABLE (DDT) 
The Demountable Device Table follows the MST in CMR. 



Fixed 
Section 



Variable 
Section 



One Entry for 
Each RMS EST 



One Entry for Each 
Device Requested 
That is Not On-Line 



Entry Size - 2 CM Words for Variable Section 
» 4 CM Words for Fixed Section 



DDT ENTRY (FIXED SECTION) 



F»1 

Not Yet 
Mounted 
(Free) 
On-line 





59 


47 


35 


23 


17 


11 


W.DOVSN 


C.DDVSN 


I 

VSN 


I 


C.ODSTAT 


ttltt 




W.DDSN 


C.DDSN 


Set Name 









C.DDEST 
EST Ordinal 



59 



47 



35 



F=0 

Mounted 
(Busy or 
Off-line) 



W.DDVSN 



W.DDORD 



C.DOVSN 



VSN 



ODD F RBR 
First Disk RBR 
(DAM) Ordinal 



CDDLRBR 
Last Disk RBR 
(DAM) Ordinal 



C.DDSTAT (EST Status) 

A = Request Idle (S.DDIDLE) 

B » Busy (S.DDBUSY) 

C = Free (S.DDFREE) 

D = Off (S.DDOFF) 

E = Relabel during deadstart (S.DDRLB) 

F = SN bit; device not mounted if set (S.DDSN) 



23 



17 



11 



CDDSTAT 

f| 



rttttrW'rf 



C.DDMST 
MST Ordinal 



C.DDEST 
EST Ordinal 



G = System Device (S.DDSYS) 
H = PF Device (S.DDPF) 
I - Queue Device (S.DDQ) 
J = Master Device (S.DDMSTR) 
K - Preallocated (S.DDPRE) 
L = Reserved (S.DDBF) 
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W.DDSTA 





C.DDNFC 

New File 

Count 


C.DDWAT 
Bypass 
Count 


* 


C.DDSR 

Number or 

Accesses 



Statistic 
Area 



C.DDACT 

Unit 

Activity 


C.DDNFC * 
Previous 
File Count 


C.DDWAT * 
Bypass 
Count 


# 


C.DDSR 
Pre number 
of Accesses 



W.DDSUM 



*Used as temporary save area by deadstart 
DDT ENTRY (VARIABLE SECTION) 



Master 
Device 



W.DDVSN 



W.DDSN 



59 


47 


35 


23 


17 


11 


C.DDVSN 


1 


1 
VSN 


C.DDSDQA 

inn 


I 
SDQ Address 
(First JDT Entry) 


C.DDSN 




Set Name 











Member 
Device 





59 


47 


35 


23 


17 


11 


W.DDVSN 


C.DDVSN ' VSN ' 


CDDSDQA 


SDQ Address 
(First JDT Entry) 


W.DDORD 


C.DDFRBR 
First Disk RBR 
(DAM) Ordinal 


C.DDLRBR 
Last Disk RBR 
(DAM) Ordinal 


C.DDSDQC 
SDQ Count 


C.DDMST 
MST Ordinal 






F = SN bit; device not mounted if set 
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VSNBUF 



if end of display 



59 



47 



35 



= used 

1 = free • 



(Bit 59 



Line Reservation B.ts Bjt 58 = |jne 2 etc , 




-VSN Information 
to be 
Displayed 



= if not 
first entry 
for this job 



Linel 



Line 2 






Line n 
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TAPES TABLE 



59 



47 



29 23 



17 11 



W.TFLN1 



W.TREEL 



W.TFLGS 



W.TVRN 



W.TVRN1 



est Ordinal 

(Binary) 


FNT Address 


Control Point 
Number 


MTorNT 
(Display Code) 


EST Ordinal 
(Display Code) 


UMNam 


Label Namf 


Position Number 


Edition Number 


Retention Cycle 


Creation Date 


Multi-File Nam* 


Reel Number 


C.TFLGS 

Flag Bits 


Reserved 


2IA/2IB 

Communication 

Area 


Vohimt Serial Number of Currant Rat) 


Last Good 
Checksum t 


Last Good 
Byte Countt 


Volume Serial Number of First Reel 


PRU Number of Lett PRU 
That Got Noitt Warning 1 



tThese bytes are not used by 66x drivers. 



NOTES: TAPES TABLE 



C.TFLGS - Job-Oriented Flag Bits 
59 58 57 56 55 54 53 52 51 50 49 48 



GO 



RC 



S.TTFGO-Gobit 
S.TTFRC-Racheckbit 

(Reserved) 
S.TTFST — Stop Staging 

(Reserved) 
S.TTFES - End of Multi-file eat 



^ 



ST 



ES 



WL 



LT 



VP 



LC 



EC 



t* 



Label expiration checked — S.TTFEC 

Label checked - S.TTFLC 

(Raaarved) 

VSN-printed bit -S.TTFVP 

Dual PP interlock - S.TTFLT 



— VtVite labels - S.TTFWL 



C.TFLGS* 1 - Unit-Oriented Flag Bits 
47 4646444342 4140393B3736 



VT 



OV 



S.TTFVT- VSN read from tape 
S.TTFOV- Operator-supplied VSN 
S.TTFSC - Scratch 
S.TTFRD- Ready 

(Reserved) 

(Reserved) 



bHj 



SC 



RD 



EL 



BL 



LB 



FS 



Rl 



W.N 



£ti 



Unexpired label w/ring-warning — S.TTFWN 

Ring in bit -S.TTFRI 

Flash save bit -S.TTFFS 

Labeled -S.TTFLB 

Blank labeled -S.TTFBL 

Expired label - S.TTFEL 
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MAILBOX 



89 



47 



17 



Entry Count 



LE.MAIL 



t 



Flags for 
M.DFM 



j.CFO Bit 



Job Descriptor 
Address 



Broadcast Box 
(Oeadstart Recovery Message) 



L.MAIL 



t 

LE.MAIL 
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ID TABLE 



59 



47 



35 



29 



23 



17 



W.tDTHID 



W.IDTLL 



W.IDTFLO 



C.IDTL 
L.IDT 


C.IDTPID 
First PID 
Ordinal 


C.IDTFLL 

LID Ordinal 
Rrst | Last 




Host ID 


(Reserved) 




Logical ID 1 




Logical ID 2 




Logical ID 3 

























Logical ID n 


C.IDSIDT 
Station 
IDT RA 


C.IDTFNO 


G.IDTEST 
EST 
Ordinal 




Physical ID 






• 




Physical ID 










Physical ID 










Physical ID 



NOTES: ID TABLE 
W.IDTHID C.IDTL 

CIDTPID 
C.IDTFLL 



(Host word) 



Bits 17-0 



W.IDTLL 



Contains the length of the ID table. 
Default is 40B. (LJDT) 

Contains the first physical ID Ordinal. 

Contains the first logical ID Ordinal in the 
upper six bits and the last logical ID 
Ordinal in the lower six bits. 

Contain the host ID as 3 letters or digits. 
Third character must be a letter. 

Reserved. 
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W.IDTFLO 



CIDSIDT 



(Logical ID entries) 
Bits 17-0 
(Link words) 



Contain a logical ID as 3 letters or digits. 

Contains the relative address of the station 
ID table. The station ID table is a copy of 
the central memory resident ID table, but 
the SIDT also contains lists of the logical 
IDs associated with linked mainframes. 



CIDTFNO 



Contains relative address of station PID 
information area. 



CIDTEST 



Bits 17-0 



Contains the EST ordinal of the PID. 

Contain a physical or link ID as 3 letters 
or digits. 



SUBSYSTEM CONTROL TABLE 

59 
T.SSCT 



T.IJCT 

Entry For 
Control 
Point 1 

Entry For 
Control 
point 2 



Entry For 
Last JOT 
Ordinal 



35 



23 



17 15 






L.SSCT 


N.SBSYS 


Subsystem Name i 


\ P 





Subsystem 
CP Number 


Subsystem Name ' 


KP 





Subsystem 
CP Number 












A 



h 



Subsystem Name 



SCP No. 



SCP No. 



SCP No. 



SCP No. 



SCP No. 



SCP No. 



SCP No. 



P 



SCP No. 



Subsystem 
CP Number 



SCP No. 



77 



sskey 



sskey 



Connection Control Fields 







N.SBSYS 



L.SSCT 



sskey values: 6 14B 228 30B 36B 44B 52B 60B 66B 
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Connection Control Field 



5 4 3 2 

|R | S | L | WR | 



R = Reserved 

S = Swap Out 

L = Long Term Connection 

WR = Wait Response Count 



Set/Increment 



SF.SWPO 
SF.SLTC 
CALL SS 



Clear/Decrement 



SF.SWPI 

SF.CLTC 

SF.ENDT 



Bit 16 (P) permits a control point to attain system control point status as the specified subsystem even if the 
job is not system origin (initiated by the operator). 

When a subsystem is active: 

Bit 17 (A) is set to 1. 

An sskey value is assigned which specifies a column of connection control fields. 

This sskey value is put in the word for the subsystem job control point number. 

The subsystem CP number is put in the subsystem word and the T.IJCT field specified by sskey. 



PERIPHERAL JOB TABLE 



PP Input Register Image 



W.PPMES4 Image 



W.PPMES5 Image 



W.PPMES6 Image 



One 
Entry 
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DAYFILE FET AND BUFFER AREA 



59 



47 



35 



23 



11 



CPO 
FET 



CP1 
FET 



CPn 
FET 

CERFILE 
FET 



Index 
( I N Pointer) 



Index 
(IN-| Pointer) 



Size 
(LIMIT -FIRST ) 



Index 
(IN n Pointer) 



Size 
(LIMIT 1 -FIRST 1 ) 



(FIRST -T.DFB) 



Remaining Number 
of Prea I located PR Us 



(FIRST r T.DFB) 



Index 
( I N c Pointer) 



(L.M.VRRSTJ ' <FIRST n -T.DFB) 



(Reserved) 



MTR Code Word 



(Reserved) 



(Reserved) 



(Reserved) 



Size 
(LIMIT C -FIRST C ) 



(FIRST C -T.DFB) 



Remaining Number 
of Preallocated PRUs 



MTR Code Word 



System Dayfile Buffer 



Control Point 1 Dayfile Buffer 



Control Point n Dayfile Buffer 



CE Error File Buffer 



T.DFB 



FIRSTn 



FIRST, 



FIRSTn 



Fl RST„ 
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SCHEDULER PERFORMANCE TABLE (SCHPT) 

Address of this table is T.SCHPT. 



59 



W.PTFL.AG 



W.PTCLK 



W.PTIDL 



W.PTSCP 



W.PTPPI 



W.PTNST 



W.PTVST 



W.PTNSW 



W.PTVSW 



W.PTTSW 



W.PTNJP 



35 



23 



S.PTNSTD 

S.PTINIT 

S.PTSTOP- 

S.PUBNCH-— > i 
S.PTFJOB-ili 



Flags 



Elapsed Time 



CPU Idle Time 



User Mode System Program Execution Time 



PPU Idle Time 



Number of Storage Moves 



Number of Words Moved 



Number of Swap-outs/Roll-outs 



Number of Words/1 00B Swapped-out/Rolled-out 



Time to Get All Quiet 
(seconds/4096) 



Number of INTERCOM 
Commands Processed 



Time to Swap-out Jobs 
(seconds/4096) 



Number of Batch 
Jobs Processed 



Number of CPMTR Calls 



Reserved for Storage of Intermediate Times 



S.PTNSTD — Manual/benchmark option selected 

S.PTINIT - Initialization of TSPT 

S.PTSTOP — Stop data gathering 

S.PUBNCH — Benchmark option selected 

S.PTFJOB — First Job execution started 
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JOB CONTROL AREA 



Input 
Queue 
Entry 



Class 1 

(No 

Non-allocatable 

Devices) 



Class 2 

(Non-allocatable 
Devices) 



Class3 

(Interactive 
Jobs) 



Class 4 

(Multi-user 
Jobs) 



Class 5 

(Express 
Jobs) 



Class 6 

(Graphics 

Jobs) 



59 



47 



35 



23 



17 



11 



C.JCMXB 

Max # Class 

1 Batch 


C.JCMTB 

Max # Class 

2 Batch 


CJCCLK/ C.JCQP 
CJCAFL Ml Quantum 
a bcd Priority 


C.JC8Q 

Quantum 

Value 


CJCCNB 

Current* 

Class 1 Batch 


C.JCCTB 

Current* 

Class 2 Batch 


C.JCEMC 

# Empty FNT 

Entry 


C.JCNTJ 
e # Ready-to- 
run Tape Jobs 


CJCNJI 

f # Ready-to-run 

Non-tape Jobs 


C.JCMIN 

Minimum 

Class Priority 


C.JCMAX 

Maximum 

Class Priority 


C.JCAR 
Aging Rate 


C.JCQP 

Quantum 

Priority 


CJCBQ 

Quantum 

Value 


C-JCNAM 
Name of 
Job Dlass 




C.JCFRST 

Address of First 

JDT in Chain 


C.JCMIN 


C.JCMAX 


C.JCAR 


C.JCQP 


CJCBQ 


C.JCNAM 




CJCFRST 


C.JCMIN 


C.JCMAX 


C.JCAR 


C.JCQP 


CJCBQ 


C.JCNAM 




CJCFRST 


C.JCMIN 


C.JCMAX 


C.JCAR 


C.JCQP 


CJCBQ 


C.JCNAM 




C.JCFRST 


C.JCMIN 


C.JCMAX 


C.JCAR 


C.JCQP 


CJCBQ 


C.JCNAM 




C.JCFRST 


C.JCMIN 


C.JCMAX 


C.JCAR 


C.JCQP 


C.JC8Q 


C.JCNAM 




CJCFRST 



a ■ Anticipated FL/1000B 

b - 1 Increment to AFL for INTERCOM (AFL.INT) has been added (SJCAFL) 

c = Reserved 

d = 1 1IB failed to initiate a job last time called (SJC1I8) 

e = 1 Fixed priority tape jobs in Input Queue 

f = 1 Fixed priority non-tape jobs in Input Queue 
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JOB DESCRIPTOR TABLE ENTRY 



59 



47 



38 35 



23 20 17 



11 



VMDNAM 
WJDLNK 



WJDSWP 
W.J0DS0 
WJDMGR 
WJDINT 



C.JOLNK 
Job Name . Link to Next JOT 

1 in Chain 


C.JDEQC 
Eq. Code MST ord. 


CJOFR8 
First RBT 
Word Pair 


CJDIFLG 
C.J0FLG 
Flags 


CJDFL 
FL/100B 


C.JDPFL 
Positive FL 


CJDCPN 
CP# | Priority 


C.JOORD 
J.O. Ordinal 


C.JD0PF 
CJOTL | Operator 
Time Left 1 Flags 


C.JDORG 
SSW | Origin 


C.J0JST 
Job St. | Class 


CJOPFM 

CJDTIN Time into Chain 

PFMBit$| 


CJDBP 
Base Priority 


CJOLPFL 
C.JDRU 
PFL/100B| PP/CP 


C.JDID 

INTERCOM 
User 10 


CJOCPT 
CPU Time 


C.JOSID CJOIUTA 

Source Mainframe ID User Table 
I Address 



NOTES: JOB DESCRIPTOR TABLE 
WJDNAM(0) Bits 18-59 

WJDLNK Bits 00-17 



WJDSWP(l) CJDEQC(0) 
CJDFRB(l) 



C JDFLG(2) 
CJDIFLG(2) 


Bit 35 
Bit 34 


SJDBGB(43B) 
SJDNRR(42B) 




Bit 33 


SJDLGI(41B) 




Bit 32 


SJDLCO(40B) 




Bit 31 


SJDNJ(37B) 




Bit 30 


SJDECS(36B) 




Bit 29 


SJDSKFL(35B) 



Job name as found in job input FNT 

Contains address of next job descriptor 
in the chain. (CJCFRST in JCA points 
to first entry in chain; a zero field 
denotes last entry in chain) 

Contain the equipment code, MST ordinal, 
and first RBT number of the swap file 
(FJDSWI in word W.JDMGR is set); else 
contain first subpage address of ECS swap 
file 

Set if recovery took place 

Set if job cannot be rerun 

Set if no swap file exists and control 
point area must be initialized (e.g. 
LOGIN) 

Set if no swap file is to be generated 
for this INTERCOM job (e.g. LOGOUT 
command) 

Set to indicate control cards must be 
read from INTERCOM area 

Set if swap file is on ECS 

Set if FL is to be skipped on swap file 
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NOTES: JOB DESCRIPTOR TABLE (CONT'D) 

Bit 28 SJDROLL(34B) 

Bit 27 SJDNFNT(33B) 

Bit 26 SJDFAZ(32B) 

Bit 25 SJDINTR(31B) 



CJDFL(3) 



CJDPFL(4) 



WJDDSD(2) CJDCPN(0) 



Bit 24 



CJDORD(l) 






CJDTL(2) 






CJDOPF{3) 


Bits 23-21 
Bits 20 






Bit 19 


SJDTLI(23B) 




Bit 18 


SJDEXP(22B) 




Bit 17 


SJDGO(21B) 




Bit 16 


SJDNS(20B) 




Bit 15 


SJDLOK(17B) 




Bits 12-14 





Set if job cannot be swapped out 

Set if 1AJ should not search FNT table 

Set if file at control point 

Set to terminate INTERCOM job on 
recovery deadstart 

Unused 

Contains the FL/100, including the job 
control block which is created when job 
is swapped out, needed to swap this 
job in 

Contains the relative starting address/ 100 
of the job control block when present 
for job swapping; otherwise, contains 
zero 

Contains control point number in upper 
6 bits. (Set when job is in execution or 
rolled out.) In lower 6 bits, job or 
rerun priority 

Contains job descriptor (JDT) ordinal 

Contains job time left (upper 12 bits) 

Contains flags set by operator 

Low order 3 bits of time left 

Currently not used 

If job is to be temporarily locked in to a CP 

If job is to be placed in express queue 

If operator typed GO 

If job must not be swapped out or 
rolled out when at a control point 

If job must not be brought to control 
point 

Error codes: FJDKILL, FJDDROP, 
FJDRRUN, FJDRRNP 
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NOTES: JOB DESCRIPTOR TABLE (CONT'D) 

CJDORG(4) Bits 11-06 Sense switches 

Bit 05 SJDINT 

Bit 04 S.JDMUJ 

Bit 03 SJDGR 

Bit 02 SJDRT 

Bits 01-00 

W.JDMGR(3) C JD JST(0) Bits 54-59 



7x 


FJDWMM 


6x 


F.JDWPK 


5x 


F.JDW1A 


4x 


FJDWOA 


3x 


FJDWDA 


2x 


FJDWPF 


lx 


FJDWCM 


Ox 


FJDLMB 


x3 


FJDWCC 


x2 


F.JDACT 


xl 


F.JDSWI 


xO 




Bits 48-53 




06 


FJDGRA 



Set for a standard INTERCOM job 

Set for a multi-user job 

Set for a graphics job 

Set for a real time job 

Currently not used 

Values describe the job status 

If job is waiting for MMF action 
(GETPF, SAVEPF, PURGE) 

If job is waiting for permanent pack 

If job is waiting for INTERCOM action 
(in INTERCOM queue) 

If job is waiting for operator action 
(in operator action queue) 

If job is waiting for device assignment 
(in device queue) 

If job is waiting for a permanent file 
availablity (in permanent file queue) 

If job is waiting for central memory 
(in central memory queue) 

If job is waiting for entry in a sched- 
uling structure (in limbo) 

If job is being swapped or rolled out 

If job is currently executing at a 
control point (is active) 

If job is being swapped or rolled in 

If job is swapped or rolled out 

Contain the job class values 

For graphics job 
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NOTES: JOB DESCRIPTOR TABLE (CONT'D) 

OS FJDEXP 





04 


F.JDMUJ 




03 


FJDINT 




02 


FJDBNA 




01 


FJDBAT 


CJDPFM(1) 


Bit 47 
Bit 46 
Bit 45 
Bit 44 
Bit 43 
Bit 42 




CJDTINO) 


Bits 41-24 




CJDBP(3) 


Bits 23-12 




C.JDRU(4) 
C.JDLPFL(4) 


Bits 5-0 





WJDINT(4) C.JDID(0) 

CJDCPT(l) 
C.JDSID(2) 



Bits 11-6 

Bits 5948 

Bits 47-36 
Bits 35-18 



C.JDIUTA(3) Bits 17-0 
C.JDIUTA+1 



If express handling was requested for 
this job 

For multi-user job 

For standard INTERCOM job 

For batch job with non-allocatable 
device requirements 

For batch job with no non-allocatable 
device requirements 

Contains information used by permanent 
file manager 

Purge bit 

Exclusive access desired 

Control permission desired 

Modify permission desired 

Extend permission desired 

Read permission desired 

Contain the time at which job descriptor 
was attached to job class chain 

Contain job base priority 

Contain ratio of PPU time to CPU time 
used by job during its last execution 
(if job is swapped out) or since start of 
job (if job is rolled out). 

Positive field length/ 100B of job control 
block created at swapout time 

INTERCOM user ID associated with 
remote batch job 

CPU time, in seconds, used by this job 

Source mainframe identifier 

Address of User Table for interactive or 
graphics jobs, or MUJ Table for multi-user 
jobs 
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BREAKPOINT TABLE 



53 



35 



T.BR KPT 



W.BKPXP 



27 23 



4- 



W.BKLMT 



W.BKCOM 



W.8KFLG 



W.BKPLP 



W.BKTBL 



W.BKPTS 



Breakpoint 
Entry 



Flag* 



RJ 



T.BRKPTt 
L.BRKPT 



•4 



Exchange Package for Breakpoint 



DSD ECS Buffer 
Address 



EQ 



Breakpoint 
Address 



Breakpoints 
Upper Limit+1 



DSD Communication Word 



Breakpoint Flag Word 



L.BRKPT 
-W.BKTBL 



Segment Table 
Address 



Saved Instruction Word 



Breakpoint Entry Word 



T.BRKPT+W.BKFLG 



Other Breakpoint Entries 



17 



Breakpoints Lower 
Limit-1 



•♦1 



Link 



19 
20 

21 

22 

23 

24 

25 

26 

27 

30 



31 
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NOTES: BREAKPOINT TABLE 
W.BKLMNT (20B) Bits 0-17 

18-35 
36-59 
Bits 0-11 



W.BKCOM (21 B) 
(Set by DSD) 



W.BKFLG (22B) 



12-23 
24-59 
Bits 0-30 
30-47 
48-59 



W.BKPLP (23B) 




W.BKTBL (24B) 


Bits 0-23 




24-35 




36-59 


Breakpoint Entry 




Word 


Bits 0-17 




18-35 




36-53 




54-59 


Word I 




Word 2 





Word 3 



First absolute address that may be breakpointed -1 

Last absolute address that may be breakpointed +1 

DSD ECS display buffer 

Mode flag = 1 monitor 
= user 

Breakpoint entry relative address +4 (to be processed) 

Non-zero if bits 0-23 are zero 

Reserved 

Breakpoint entry table address +3 (if flag - 400B) 

Processing flag 
400B breakpoint bit 
200B breakpoint processed 
100B restart CPU 
1000B release breakpoint 

Breakpoint wait loop 

Start of breakpoint entries 

Number of breakpoint entries *4 



Link to next breakpoint entry for the segment (end of chain=0) 

Address of segment table entry for segment or 

Breakpoint address 

Processing flag 

Saved instruction word (from breakpoint address) 

Entry word; breakpoint word is replaced with a return jump to 
this word 

Return jump to breakpoint wait loop 
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AREA TABLE 



59 



35 



17 



T.AREA 
W.CURSYS 

W.ALTSYS 

W.CMRES 

W.MTRA 

W.USERA 

W.SEGT 

W.INIT 

W.EDT1M 



Current System ECS Address 


Alternate System Address 
(or Terminator) 


ECS Address 


Length 


CM Address 





Length 


CM Address 





Length 


CM Address 


ECS Address 


Length 


CM Address 


ECS Address 


Length 


CM Address 


Date-Time Stamp 
(from ECS System) 



NOTES: AREA TABLE 
W.CMRES(2) 
W.MTRA(3) 
W.USERA(4) 
W.SEGT(5) 
W.INIT(6) 
W.EDTIM(7) 



CM resident descriptor word 

Monitor mode overlay area descriptor word 

User mode overlay area descriptor word 

Segment table descriptor word 

Initialization segment descriptor word 

Date-time stamp of CMR for which this ECS system was loaded. Last digit of year, 
ordinal date (3 digits), two digits hour, two digits minutes, and two digits seconds, 
all in display code. 
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ENTRY TABLE 

59 



T. ENTRY ) 
W.DTIME f 



W.SGLIB 



W. ENTRY 



17 



11 



CMR Date Time Stamp (Assembled) 


Segments Library Name 


CPO ECS 
FL/1000B 


CMR Entry Point Name 


Absolute Address 









Additional Entry Point Names and Addresses 



r m ". 



NOTES: ENTRY TABLE 
| W.SGLIB (1) 

W.ENTRY (2) 



Library containing segments to be used with this CMR. Control 
point FL/1000B is used for ECS system code. 

List of entry points defined in CMR 
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SEGMENT TABLE 



Entry 





59 




35 


17 









(Used by Overlay Step Mode) 




ECS Address 


Length 


CM Address 


1 


B 


• 
Segment Name in Display Code 




Link 




i 


S 


ECS Address 


Length 


CM Address 

















Additional Segment Table Entries 



NOTES: SEGMENT TABLE 




Word 






Word 1 






Words 2 & 3 






Segment Table Entry 






Word 


Bits 


0-17 

18-58 

59(B) 


Word 1 


Bits 


0-17 
18-35 
36-58 
59 (S) 



Step mode communication word 
ECS system resident descriptor word 
Segment Table Entries 

Link to error directory entries or breakpoint entries 

Segment name in display code, left justified, zero filled 

Breakpoint flag 

CM address where segment should be loaded 

Segment length (exclusive of ECS error recovery information) 

ECS address of segment 

Step mode flag 
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CEFAP BUFFER AREA 



T.BCFAP 



CEM-Working Flag 



Buffers 



Buffer for Error Codes 0-3 



XO = ECS FWA of Transfer 



A0 = CM FWA of Transfer 



Bj+K = Length of Transfer 



Exact ECS Address of Transfer 



CEFAP Error Code (Unweighted) 



Pointer to Next Buffer (0 = End of Chain! 



Buffer for Error Codes 20-27 



ECS FWA of Transfer (or Unused) 



Port Channel 



Length of Transfer (or Unused) 



PPNT Address + 1 



CEFAP Error Code 



Pointer to Next Buffer (0 = End of Chain) 



Error Code (Unweighted) 

= Write Abort 

1 » Read Parity Error 

2 » Recovered Read Parity 

3 = Interlock Register Abort 

20 = Unclassified DDP Error (DDP Reply - 0) 

21 = DDP Found ECS Abort (DDP Reply = 1) 

22 = DDP Channel Drops Active 

23 = DDP Channel Stays Full 

24 = DDP Found ECS Read Parity Error (DDP Reply = 4) 

25 = Unclassified DDP Error (DDP Reply = 5) 

26 = DDP Unable to Connect 

27 = DDP Logically OFF 

30 = Reserved for RMS 

31 = Unit not ready 



32 = Positioner not ready 

33 - 6681 INT/EXT reject 

34 • Unit busy too long 

35 = Recovered RMS error 

36 • Unrecovered RMS err 

37 = Channel stays active 

40 = Unable to connect 

41 = 660311 position fail 

42 = Reserved for RMS 

43 - Reserved for RMS 

44 «■ No status returned 

45 = Reserved for RMS 

46 - ADDR byte not accept 
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EMPTY PAGE STACK 



T.EPAGE 



59 



23 



FWA of ECS Page 



FWA of ECS Page 



L.ECSTK 



(A6 + B5 in CP.MTR exchange 
package points to next entry) 



59 



35 



23 



17 



T.ECSPRM 





C.BCFAPL 
L.BCFAPA 


w 


C.BCFAP 
T.BCFAP+1 



W.BCFAP 
W.ECTL 
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SUBPAGE BUFFER 

59 47 

T.SUBPG 



35 



23 



17 



Subpage Type 


FWA of this System Page 


Page Address of Current 
Data if Input Buffer 


File Name 


Number of Available Words 
in Page if Output Buffer 




JDT Ordinal 


Maximum Buffer Length 


Record Descriptors 



RECORD DESCRIPTORS 

59 55 51 



41 



23 



id= 
10XY 


Level 




Data Length 


Data Address 


X = 1 Beginning of a new data page 

Y = 1 Transmission RMS parity error flag 


23 





id= 
11XY 




Data Length 


Data Address 


X = 1 Beginning of a new data page 

Y = 1 Transmission RMS parity error flag 


23 





id= 
0100 




Next Subpage Address 




23 





id= 
0110 




Previous Subpage Address 


47 


23 





id=» 
OOOX 




FWA of Available Space 
in Data Page 


Current Buffer Length 


X = End of ECS buffer 

X = 1 End of Information on disk 

41 


23 





id= 
0010 




Index of First Entry 
in Preallocated Space t 


Address of Preallocated 
Space in ECS t 



Record 



Split Record 



Forward Link 



Backward Link 



End of 
Descriptor List 



Beginning of 
Descriptor List 



t Used only for the library 
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NOTES: SUBPAGE BUFFER 



Subpage Type (bits 59-48) 
Subpage Position (bits 49-48) 

00 = continuation subpage 

01 = first subpage in a file 
10 s last subpage 

Data Type 



Bit 50 


release data as read 


51 


(reserved) 


52 


I/O buffer (with bit 50) 


53 


library file (ZZZZZ06) 


54 


ECS resident file 


55 


swap file 


56 


auxiliary file for ECS resident random file 


57 


index for random ECS file 


58 


(reserved) 


59 


(reserved) 


id (bits 59-56) 





OXXX = system descriptor 

0000 ~ end of list; continued on disc 

0001 = end of list; EOI on file 
0010 = beginning of list 

0100 = forward link pointer 

0110 = backward link pointer 
1XXX - data descriptor 

10XX = full record descriptor 

11 XX = split record descriptor (full record described by this and next descriptor) 

1X0X = current data page 

1X1X = new. data page 

1XX0 = no parity error 

1XX1 = parity error in record 
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SCB (System Circular Buffer) 

59 47 41 



35 



23 



17 



OOOOOOB 



FNT Address 



DDP Channel 



t 



t 



Total Number 
of Data Paths 



ECS Buffering 
Extension Address 



End of 
Index 



|_oad to SCB (ECS to Disk) 
Sub page 



End of PreaHocation (Disk to ECS) 
Index Subpage 



00 



Length of Buffer 



Previous CBM Pointer 
Value (In/Out) 



Direction 



00 



00 



00 



00 



00 



00 



Wait Flag 



DDP EST 
Address 



Number of 
Available Data Paths 



Circular Buffer 

(Length in PRUs is 101 B Words/PRU for 

CM Data Path and 1B Word/PRU for DDP) 



First 



In 



Out 



Limit 



Trigger 



D - Direction (0-Disk to ECS, 1-ECS to Disk) 
T - Type (0-CM Data Path, 1-DDP) 
F - Free/Busy (0-Busy, 1-Free) 



DTF 



Header 
Word 



8 Words 

Per 
Data Path 



Length (PRUs) 

Specified 

on ECSBUF 

Macro 



7 
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CMR LIBRARY DIRECTORY 

59 
T.LIB 



41 



23 17 



. 


LWA-M of LNT 


Library Name Table <LNT> 
(5 Word* per Entry) 




LWA+t of PP J 
Program Bodies 


LWA+1 oi PPNT 


PP Program Name Tabla (PPNT) 
\2 Words per Program) 


PP Program Bodies 




CM Resident Libraries 



LIBRARY NAME TABLE ENTRY 





59 


35 


New Library — 
Modified Library — 
Use Disk Address - 


CM Library — — . 
ECS Library - — . 
ZZZZZ03 Library-, 

14 3 




Library Name 




Entry Point 
Name Table 


Address of ECS 
Descriptor 


CM FWA of 
Library 


Disk Address of 
Library 


External 
Reference Table 


Address of ECS 
Descriptor 


CM FWA of 
Library 


Disk Address of 
Library 


Program 
Number Table 


Address of ECS 
Descriptor 


CM FWA of 
Library 


Disk Address of 
Library 


Program 
Name Table 


Address of ECS 
Descriptor 


CM FWA of 
Library 


Disk Address of 
Library 
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PP PROGRAM NAME TABLE ENTRY 



59 



41 38 35 



23 



ZZZZZ03 Resident - 

ECS Resident • 

CM Resident • 

Control Card Callable - 

17 14 



PP Program 
Name 



Length in 
CM Words 



ECS Address 



* CM Address 



Access 
Level 



Short Disk Address 
if in CM or ECS 



Long Disk Address if not in CM or ECS 



*For ECS resident overlay, field holds last consecutive access failure count. If failure count overflows a 
set threshold, residence changes to RMS. 



CM RESIDENT LIBRARY FORMAT 

59 47 35 



17 



11 



Length 
of PNT 


Length 
of PNUT 


Length of 

ERT 





Length of 
EPNT 


Entrv Point Name Table (EPNT) 
(1 Word per Entry Point) 


External Reference Table (ERT) 
(1 Bvteper External Reference) 


Program Number Table (PNUT) 
(1 Byte per Entry Point) 


Program Name Table (PNT) 
(2 Words per Program) 


Library Program Bodies 
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EPNT ENTRY FORMAT 

59 



17 14 



Entry Point Name 



Access 
Level 



ERT ENTRY FORMAT 



Control Card Callable 

000 = Relocatable 

001 = Overlay (50 Table) 

010 - Overlay (51 Table) 

011 = Overlay (53 Table) 

100 ■ Overlay (54 Table, no ECS) 

101 - Overlay (54 Table with ECS) 



i 



Entry Point 
Number + 1 



Entry Point 
Number + 1 



Entry Point 
Number + 1 



Entry Point 
Number + 1 



Entry Point 
Number + 1 or 
Continuation 



PNUT ENTRY FORMAT 



Parcel 

Relative 
PNT Address 


Parcel 1 

Relative 
PNT Address 


Parcel 2 


ParcelS 


Parcel 4 


Parcel 5 


Parcel 6 






Parcel n 



PNT ENTRY FORMAT 



59 


00 - Disk Address I 

01 - CM Address \ -i 
10 "ECS Address 1 

35 17 14 


— • - 1 " Program on 
ZZZZZ03 

r* PL Override Allov 
10 


Program Name 




PL Required 
Divided by 100B 


ECS or CM Address 


Length of 
Binary Program 




Disk Address 
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INTERCOM POINTER AND BUFFER AREA 

59 S3 47 41 35 



29 



23 



11 



3 



W.IMSG1 


J 

4C 


•^ Message from Terminal to Operator 


< 
I 


W.IMSG2 


^ 




INTERCOM Status for Operator 


1! 


W.IOPR 


_, Message from Operator to Terminal 


11 
2 


W.IEMBF 


C.INBUF 
I 


Small Buffer 
Empty Chain Pointer 




CIBSTAT 

Buffer ______«,_ 

Status j * 


2 


W.IRSTRT 


C.IRSTRT 

Non-zero if 
restart initiated 


2 


W.IUSER 


C.INBUF 
00 I 


User Table 
Chain Pointer 


C.INUSER 

Number of 
User Tables 






2 


W.IMUJ 


C.INBUF 
00 | 


MUJ Table 
Chain Pointer 


C.INMUJ 

Number of 
Active MUJs 




C.IQPINT 

Interlock ^ 
Bit T 


3 


W.IGUTC 


C.INBUF 
° I 


Graphics Table 
Chain Pointer 








W.IUSEW 


C.IUEST 
CIUPORT. 
Pseudo I 
Ordinal | 


Port 
Number 


C.IUSITE 
C.IUSTIN . 

Site 1 Station 
Address | Address 


C.IUWUSR 

I Address of First 
; New User Table 


C.INWSTS 
Request J, 


*" 




Status " 




W.IMES 


C.IUEST 
C.IUPORT 

Pseudo 1 

Ordinal 


Port 
Number 


C.IUSITE 
C.IUSTN 

Site 1 Station 
Address I Address 








W.1 1 BR 


C.IDROP 

Reserved 


C.IPTIME 

1BR Timer 


C.IPPRD 

1 Address of 
1 PPRES for Drivers 


Reserved 




W.IT76 




C.IT76 

Interlock Bit tf 




W.IGRES 


C.INBUF 
I 


Con 


sole Reservation 
fable Pointer 


C.IGEJ 

Ports for Which 
GEJ Called 


C.IGEJC 

Number of Copies 
of GEJ 


C.I G INT 

Interlock Bit 4 





















IM-96 
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INTERCOM POINTER AND BUFFER AREA (CONTD) 



59 



53 



47 



41 



35 



29 



23 



17 



11 



W.I LCC 

W.ICT8L 

W.IPEST 

W.IPES2 

W.IPES3 

W.tOCA 

W.I9ZD 

W.IBBUF 

W.IINT 



Only Present 
If CCC'sin 
the EST 



Only Present 
If 2550's in 
the EST 



Only Present 
If Graphics 
Defined 



C.IS1ZZ 
00 1 


Pointer to FWA 
of 8ZZ Area 


C.IS2ZZ . Pointer to FWA 
00 1 of LCC Overlay Area 


Unused 


C.IS1FE. 
00 


Pointer to FWA 
of 8FE Area 


C.ICNCT. Pointer to FWA 
00 I of Connection Table 


C.ICNUM 
Num. of NPUs 


I 


Pseudo 

EST 

1 


Pseudo 
1 EST 
I 2 


Pseudo 
| EST 
1 3 


Pseudo 
i EST 

1 * 


Pseudo 
f EST 
I 5 


I 


Pseudo 

EST 

6 


Pseudo 
1 EST 

I 7 


Pseudo 
1 EST 
1 8 


Pseudo 
1 EST 

1 9 


Pseudo 
• EST 

I 10 


I 


Pseudo 

EST 

11 


Pseudo 
EST 
I 12 


Pseudo 

! EST 
1 13 


Pseudo 
| EST 
1 14 


Pseudo 
1 EST 
1 15 


C.IDCA | 


Pointer to DCA 


C.ILEDCA 
Size of DCA 


Unused 


C.I9Z9 . 
00 I 


FWAof9ZD 


C.IC59ZD 
9ZD Checksum 


C.IL9ZD 
Length of 9ZD 




C.IBBUF. 
00 


FWA of First 
1LX Buffer 


C.IBBAV 
Buffer Available 






y INTERCOM Interlock Table 




— Driver Communication Area (OCA) C. 


•* LCC 8ZZ Area ^ 


7 LCC Overlay Area ~J 


|7 NPU8FEArea ". "y 



NPU Connection Table 



Console Reservation Table 



PP Resident for Drivers 



9ZD-Driver Dump Program 



1LX CM Buffers 



37 



40 



41 



42 



43 



44 



45 



46 
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INTERCOM INTERLOCK TABLE 



W.IINT 
(System Word) 



(Driver Word 1) 



59 S3 




36 29 




11 





CIINTWD 
| 


Addrenof 
Word Interlocked 


CIINTPP 

°° 1 


Name of 
PPU with Interlock 




CIINTWD 

1 


C.HNTPP 

1 


CIINTDP 

Driver Flags 















(Driver Word n) 



(1 BR Word) 



CIINTWD 



CIINTWD 



CIINTPP 



CIINTPP 



CIINTDP 



CONSOLE RESERVATION TABLE 

69 S3 



C.IGAV 
CIGWT1 

Flags 



CIGAV 
C.IGWT1 



35 



23 



Address of First 
Queued User Table 



CIGWT2 



CIGUTA 



Address of Second 
Queued User Table 



11 



Address of 
Attached User Table 



CIGWT2 



CIGUTA 



Filler to 20B Word Boundary 



IP.IGCON-1 



H-l-98 
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INTERCOM CONNECTION TABLE 

59 47 



35 



23 



11 



Connection 



-nection 1 



-nection 2 



-nection 3 



Con- 



Connection 4 



Connection 5 



Each Connection Table entry contains 4 bytes (48 bits). 
It is used by the Front End. 

CONNECTION TABLE ENTRY FORMATS 



Con- 



Con- 



Etc. 



Connection 



47 41 




5 


11 


7 


3 


C.ISHST " 

BH | 
State J 


C.IBN 


B 


D 


A 


U 



C.IBHST 

Bits 11-06 



S.IBHST 
L.IBHST 



Block Handler state 
Block Handler state length 



C.IBN 



Bits 03-00 S.ILBOBN 



C.IBN+1 

Bits 



Connections 1-N 

C.IBHST 

Bits 11-06 



47 41 

C.IBHS T — 
C.ICNUT, 
BH 
State I 



Block Serial Number (BSN) of last BACK-ed 
downline Service Message (SM) block. (B) 



11-08 S.ILSOBN BSN of last downline SM block sent. (D) 

07-04 S.ILBIBN BSN of last BACK-ed upline SM block. (A) 

03-00 S.ILRIBN BSN of last upline SM block received. (U) 

L.IBN BSN field length 



T 



27 23 



UT adtiress/208 | d 
i e 

' lx 



S.IBHST 
L.IBHST 



15 11 7 3 



C.INCN 

C.IBN 

Link 



Block Handler state 
Block Handler state length 



C.ICNUT 

Bits 



05-00 



Upper 6 bits of User Table (UT) address/20B 
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II- 1-99 • 



C.ICNUT+1 






Bits 


11-04 
03-00 




C.INCN 






Bits 


11-04 


S.INCN 


C.IBN 






Bits 


03-00 


S.ILBOBN 


C.IBN+I 






Bits 


11-08 


S.ILSOBN 




07-04 


S.ILBIBN 




03-00 


S.ILRIBN 
L.IBN 



Lower 8 bits of UT address/20B 
Stream Index 



Ordinal of next linked Connection Table entry. 



Block Serial Number (BSN) of last BACK-ed 
downline block. (B) 



BSN of last downline block sent. (D) 

BSN of last BACK-ed upline block. (A) 

BSN of last upline block received. (U) 
BSN field length. 



INTERCOM DRIVER COMMUNICATION AREA (DCA) 

STANDARD DCA ENTRY 

59 53 47 



W.IDCA0 



W.IDCA1 



W.IDCA2 



C.IDCFLG 



C.IDCFL.G 



CIDCFLG 



Primary DCA Entry Service Flag 



OCA Word Service Flag 



DCA Word Service Flag 



W.IDCA0 
CIDCFLG 

Bits 11-06 



S.IDCFLG 



W.IDCA1 and W.IDCA2 
CIDCFLG 

Bits 11-06 S.IDCFLG 



0=No service required from standard INTERCOM service 

routines for any word in this DCA entry. 
l-77B=Service required for entire DCA entry. 



0=No service required from standard INTERCOM service 

routines for this word. 
l-77B=Service required for this word. 

The primary DCA entry flag (in W.IDCAO) must be 

non-zero for service to occur. 



II-1-100 
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2550 FRONT END NPU DRIVER DCA ENTRY 
59 53 50 47 36 



W.IDCAO 



W.IDCA1 



W.IDCA2 



CIDCFLG 
C.iDCEC 



DCEQ 

ill 



-1 



CIDCFLG 
CI DCEQ 

1 



C.IDCADR 



CIDCADR 



Address of Mux Subtable Header for E 



Address of Mux Subtable Header for E- 



W.IDCAO 
CIDCFLG 

Bits 11-06 



05-03 
C.IDCEQ 

Bits 02-00 

CIDCADR 

Bits 11-00 

W.IDCA1 
CIDCFLG 

Bits 11-06 

05-03 
CIDCEQ 

Bits 02-00 
CIDCADR 

Bits 11-00 

W.IDCA2 



S.IDCFLG 
L.IDCFLG 



S.IDCEQ 
L.IDCEQ 



S.IDCFLG 



S.IDCEQ 



0=No service required from standard INTERCOM service 

routines. 
Service flag field length. 
Reserved. 

Equipment number of 1st NPU on channel (Ej). 
Equipment number field length. 

Address of Mux subtable of 1st NPU on channel. 



G=No service required from standard INTERCOM service 

routines. 
Reserved. 

Equipment number of 2nd NPU on channel (E2). 

Address of Mux subtable of 2nd NPU on channel. 

Reserved. 
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INTERCOM BUFFER AREA 

SMALL BUFFERS (20B Word Boundary) 

W.IUSTA 



59 53 




35 


11 


3 


C.INBUF 



Address of Next 
Buffer in Chain 




C.IBSTAT 
Buffer 




Status 















-V 



L.IBUFF Next Small Buffer 



Byte CIBSTAT 

Bits 3-0 S.ITYPE 



Buffer Status 

=0 Empty 

=1 User table 

=2 Data output/job card 

=3 Data input 

=4 Interactive control cards 

=5 Multi-user job table (MUJ) 

=6 Auxiliary user table (AUT) 

=7 Graphics job 

=12B Limbo buffer 



| III- 



102 
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USER TABLE 



59 



53 



47 



41 



35 



29 



23 



11 



W.IUSTA 



W.I 
W.I 
W.I 



UCMD ) 
UIUP > 

utid ; 



W.IUMUJ 
Swap In 

W.IUFST 

Swap Out 
W.IINPUT 

W.IOTPUT 




W.IUEQP 



W.IUDRV1 



W.IUDRV2 



W.IUAFT 



W.IUAPP 
W.IUACP 



W.IULCMD 



W.IUATIM 



W.IINS 



C.INBUF 

1 Address of Next 
I User Table 


C.IUSID 

User I D 


C.ITIME 

Timer 


C.IBSTAT 

Buffer 

Status 


C.IUCMD 

Command 
Ordinal 


C.IUTID 

Terminal ID 


C.IUIUP 

C.IUCCA Address of Control 
Flags | Card Buffer 


C.IUSTAT 

User Status 


C.IUMORO 

MUJ Ordinal 




C.IUMJP 

. Address of 
| MUJ Table 


C.IUMJS 

MUJ Status 


C.IUJDA 

Address of JDT 




C.IUFILE 


C.IUEQC 

Swap 
Equipment 


C.IUFRB 

Swap First RBT 


C.IUFL 

Swap Field 
Length/IOOB 


C.IUPFL 

Positive Field 
Length/1 00B 


Flags 


File 
Count 


C.IDINOT 
C.IDPPTR 

I Interactive Input 
A| OUT Pointer and Byte 


C.IDININ 
C.IDDPTR 

1 Interactive Input 
B | IN Pointer and Byte 


C.ISIZPG 

Page Size 


C.IDOTIN 
C.IDPPTR 

I I I Interactive Output 
A|C|D| IN Pointer and Byte 


C.IDOTOT 
C.IDDPTR 

j Interactive Output 
B j OUT Pointer and Byte 


C.ISIZLN 
C.IMXL 

E Line Length 


Special Directive 


C.IGSON 
C.IGFLGS 


C.IDVTLP 

Line Printer 
Divert ID 


C.IDVTCP 

Card Punch 
Divert ID 


C.IJBCRD 

. Address of Job 
Card Buffer 


C.IXSTAT 

Export 
Status 


C.IUEST 
C.IUPORT 

EST j Port 
Ordinal | Number 


C.IUSITE 
C.IUSTN 

Site I Station 
Address | Address 


C.IUAUT 

1 | Address of Auxiliary 
C j j User Table 


C.IUPRO 

I Terminal 
A| Type 


Driver Word 1 (Driver Dependentl 


Driver Word 2 (Driver Dependent) 


C.ICUFL 

Current 
FL/100B 


C.IMXFL 

Maximum 
FL/100B 


C.ICUTL 

Current Time 
Limit 


C.IMXTL 

Maximum Time 
Limit 


C.IMXFI/C.IUVC 
■ Re- 1 Maximum 
A 1 served 1 Files 


C.IUACS 
C.IUACCS 

Access Level 


C.IUFLGS 

User Flags 


C.IUACP 

Accumulated CP Time 


Last Command for Operator 


. Date of LOGIN (YYDDD) 


Time of LOGIN (HHMM) 


Reserved for Installations 



10 



12 



13 



14 



15 



16 



17 
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USER TABLE DRIVER WORDS 



6671/6676 DRIVER 



W.IUDRV1 



6671 
W.IUDRV2 

6676 



59 



47 



C.IUDRET 

Return Address 
InPPU 



C.IUDCNT 

Number of 
Character Left 
on CRT 



35 



29 



C.IDSTAT 
C.IUDRXT, 
RXT 

Counter 



23 



17 



Status 



C.IUDECD 
C.IUDCCD 
Last Con- 1 
trol Code I 



11 



Last 
ECode 



C.IUDSTA 

Station Info/ 
Message Type 



Partially Transmitted Output Word 
Current Input/Output Word 



11 



_- 12 



6673/6674 DRIVER 

59 
W.IUDRV1 

W.IUDRV2 



47 



35 



23 



11 



C.IHOPAS 

Pass Counter 


Driver Temporary Storage 


C.ISYNC 

Number of 
Sync Errors 


C.ICYCL 

Number of 
Cyclic Errors 


C.IIO 

Number of 
I/O Errors 


C.IDSEQ 

Number of 
Sequence Errors 


C.ITOTRX 

Number of 
Retransmissions 



11 



12 



LCC DRIVER 



W.IUDRV1 



W.IUDRV2 



59 



53 



C.ISTST 
Output 

State 



47 



41 



Input 
State 



First AUT Stream 
State Number 



C.IBCNT 
. Input Byte 
C Count 



35 



29 



Second AUT Stream 
State I Number 



C.IBPOS 
C.IDININ 



LL 



23 



17 



Physical Line Input 
IN Pointer and Byte 



Third AUT Stream 
State Number 



11 



Fourth AUT Stream 
State Number 



C.ICHCNT 

Number of 
Character on CRT 



Fifth AUT Stream 
State | Number 



11 



12 



2550 DRIVER 


59 


53 


47 


39 


35 


« 


11 


WJUDRV1 


C.ISTST 
Stream • 
State 


C.ISTFL 
Connection i 
Number 


CIDOTOT 


Temporary Pointer, 
Display Output 


C.ICHCNT 

Number of 
Characters on CRT 


W.IUDRV2 


C.IBSS1 

I 


Batch Stre 

I 


C.IBSS2 
C.ISTEX 
am States 

I I 




C.IDININ 
C.IXOTOT 


Temporary Pointer 


C.ICHCNT 
Number of Characters 
on CRT, Last Write 



11 



II-1-104 



60306500 K 



NOTES: USER TABLE 



W.IUSTA(0) 




C.IBSTAT(4) 




Bit 


4 


S.IDISC 


Terminal disconnected 




5-6 


S.ILOGO 


00 = user logged out 

01 = user logged in 

10 = auto-logout requested 

11 = auto-logout in progress 




7-8 


S.ISTATE 


00 = transmission state 

01 = waiting input 

10 = waiting output 

11 = active or assigned to control point 




9 


S.IRDIS 


Request disconnect 




10 


S.IUTAPE 


Request paper tape reading 




11 


S.IABRT 


Abort request 



W.IUIUP(1) 

Bit 



W.IUCMD(1) 
Bit 



6 

7 

8 

9 

10 

11 



0-5 
6 

7 

8 

9 

10 

11 



W.IUMUJ(2) 
Bit 



W.IUFST(3) 
Bits 



1 

2 

3-6 

7 

8 

9 

10 

11 



0-5 

6 

7 

8 

9 

10 

11 



C.IUCCA(2)=C.IUIUP(2) 

S.IUCCP Control cards moved to control point area 

S.INCT Command in 1CI table 

S.IUECP Editor control statements processed 

S.IUEXS Execution started 

Unused 
S.IUEDC Buffer contains control cards sent from EDITOR 



C.IUSTAT(4) 

S.IUHDIS 

S.ICMES 

SJCACT 

S.IBCTHW 

S.IMFORT 

S.INOCOM 

S.ICTAPE 

C.IUMJS(4) 
S.IMNUS 
S.IMRUN 
S.IMDIS 

S.IMBKS 

S.IMLGS 

S.IMWO 

S.IMWI 

S.IMUJ 

C.IUFILE(4) 

S.IUCNT 

S.IUEOE 

S.IUDMP 

S.IUPS 

S.IUECS 

S.IUFNT 

S.IURED 



Used by IDS to determine type of H display wanted 

MES Active 

ICI Active 

Allow commands before LOGIN 

IMPORT on at 200 UT 

Do not issue command 

Paper tape on flag 



New user 

RUN command in progress 

Reconnected after disconnect 

(Unused) 

Break sent 

Logout sent 

Waiting for output to complete 

Waiting for input 

Attached to MUJ 



Count of FNT entries in swap file 

End of execution 

SAVEFL flag 

Pause bit 

Swap file on ECS 

FNT to be associated on next swap 

REDUCE flag 



60306500 L 
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NOTES: USER TABLE (CONT'D) 



W.IINPUT(4) 

A Bit 11 
| 6-8 


C.IDPPTR(0) 

S.IINTLK 

S.IBYTE 


Interlock bit for 3TT and I/O macros 
Byte position in current word 


1 B Bit 10 

9 

| 6-8 


C.IDDPTR(2) 

S.IRLS 

S.IDRACT 

S.IBYTE 


Input line no longer in progress 

Driver not finished 

Byte position in current word 


W.IOTPUT(5) 

A Bit 11 
C Bit 10 
1 D Bit 9 

1 6 " 8 


C.IDPPTR(O) 

S.IINTLK 

S.IPWOFF 

S.I1IMF 

S.IBYTE 


Interlock bit for 3TT and I/O macros 
Page-wait-off flag for processor 
1IM interlock 
Byte position in current word 


B Bit 11 

6-8 


C.IDDPTR(2) 

S.IPRNOP 
S.IBYTE 


Driver not finished or previously inoperatr 
Byte position in current word 


E Bit 11 


C.ISIZLN(4) 

S.ILNCHG 


Line size change bit 


W.IGFLGS(6) 

Bit 9-11 
4 
3 

2 
1 



C.IGFLGS(4) 

S.IGCON 
S.IGSNIT 
S.IGDRP 

S.IGSNON 

S.IGQUE 

S.IG3TT 


(274 graphics only) 

Console for which job is queued 

SIGNON initialization 

Job dropping 

SIGNON job 

Job queued for console 

3TT flag for interrupt output 


W.IGFLGS(6) 

Bit 8 
7 
6 
0-5 


C.IGSON(4) 

S.IXOFF 
S.IGSON 
S.IGRMUX 
S.IGDSON 


(High speed INTERCOM terminal only) 

Terminal off line 

274 graphics streams defined 

Graphics MUX 

Graphics data stream number 


W.IUSTAT=W.IFLGS(7) C.IXSTAT(4) 

Bit 11 S.IXACK 
10 S.IXDRP . 
9 S.IXUTBY \ 
S.ILUTBY t 
1 8 S.IRLAUT 
7 S.IOVFL 
6 S.IMAX 
5 S.IDVTLP 
3 S.IDVTCP 


Processor drop acknowledge (1XP) 
Drop requested (1XP) 

User table release requested (1XP/1LX) 

AUT drop requested by 1CI 

Message overflow (1XP) 

Maximum message buffers assigned (1XP) 

Divert print files 

Divert punch files 
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NOTES: USER TABLE (CONT'D) 



W.IUEQP(10) 

Bits 8-11 
0-7 



Bits 

C Bit 

A Bit 
W.IUAFT(13) 

A Bit 



6-11 
0-5 



11 



11 



11 

6-10 

0-5 



W.IUAPP(14) 

Bit 11 

10 
9 
8 

7 
6 
0-5 



C.IUEST(0) 

S.IUEST 
S.IUPORT 

C.IUSITE(l) 

S.IUSITE 
S.IUSTN 

C.IUAUT(2) 

S.IUAUTR 

C.IUPOR(4) 

S.IUNOP 



Pseudo EST ordinal 
Port number 

C.IUSTN(l) 

Site address 
Station address 



AUT request bit 



Inoperative bit 



C.IUVE(4) = C.IMXFI 

S.IUVC 



CIUFLGS 

S.IUUNR 
S.ITLOK 
S.IRLOK 

S.INOLK 
S.IUREU 
S.IUSSW 



VC carriage control 

Reserved 

Maximum number of files 



Login with unrestricted password 

Lock bit 

Request job to be locked out 

(unused) 

Job locked out 

Reduce mode flag 

Sense switch setting changes 
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AUXILIARY USER TABLE 

The auxiliary user table is for batch terminals on 7077/791 and 6671. 



V.IUSTA 



WDSTIX 



t 



59 53 






35 


23 


11 


3 


C.IN6UF 
i 


Reserved 




C.IUSIO 

Terminal ID 


C.IXFLGS 

Export Flags 


C.I8STAT 

Buffer , _. 


Status 


I 6 






Data Stream Word Triplets 









r 



OUTPUT DATA STREAM WORD TRIPLET 



MSFNT 

MFC 

f.lPBCT 

.IXOTir 
MOINFO 
.IDSXST 

.IXOTOT 
.IDSLSZ 

.IDSBSZ 
.IFSTAT 



59 56 




47 


35 32 27 


23 20 




11 5 


C.ISFNT 

FNT Address 


C.IFC 

Forms Code 


C.IPBCT 

Partial Block 
Byte Count 


C.IPBPOS 
I 


Partial Block Output 
IN Pointer and Byte 


C.IXOTIN 

•I 


Output IN 
Pointer and Byte 


C.IDINFO 

Deyice , Unit 
Information [Number 


C.IDSXSX 


» C. IDSXST 
1 
Export Status 


C.IDSLSZ 

Line Size 


C.IDSBSZ 

Block Size 


C.IXOTOT 

• Output OUT 
1 Pointer and Byte 


C.IFSTAT 

Stream . Driver 
Number 1 Status 



INPUT DATA STREAM WORD TRIPLET 



ISFNT 
IPBCT 



IXINOT 
IDINFO 
IRPC 
IDSXST 

IXININ 
IDSLSZ 
IFSTAT 



59 56 




47 


35 32 27 


23 


11 5 


C.ISFNT 

FNTAddress 


C.IPDBC 
Partial Byte Count 


C.IPBCT 
Card Column Count 


CIPBPOS 

_ 1 Partial Block Input 
1 OUT Pointer and Byte 


C.IXINOT 

•1 


Input OUT 
Pointer and Byte 


C.IDINFO 
C.IRPC 

Character | Unit 
Repeat Count [Number 


C.IDSXSX | C.IDSXST 

Export Status 


C.IDSLSZ 

Line Size 


C.IBCNT 

i Input 
A 1 Byte Count 


C. IXININ 

1 Input IN 
I Pointer and Byte 


C.IFSTAT 

Stream • Driver 
Number J Status 
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NOTES: AUXILIARY USER TABLE 

W.IUSTA(0) C.KFLGS(3) 

S.ITXOUT 1LX taking 200 UT out of transmission mode 

W.ID1NF0(1) CJDINFO (for output streams) 

Bits 7-11 S.IFCMO FCM ordinal 

4-6 S.HRAIN Train type 

=3 B4 

=4 B6 

=5 A6 

=6 A9 
03 SJDSLUN Logical unit number 

»1.2CRland2 

=3 CP 

=4-7 IP1-* 



IM-108 60306500 H 



NOTES: AUXILIARY USER TABLE (CONT'D) 



W.IDSXST(1) 

Bit 



Bit 



Bit 



Bit 





C.IDSXSX(3) 


(for output stream) 


8 


S.ISNT 


No banner/lace card 


6-7 


sue 


Internal code 
=0 Display 
=1 ASCII 
=2 Binary 


9-11 


S.IEC 


External code 

=1 SB 

=2 80COL 

=3 B4 

=4 B6 or 026 

=5 A6 or 029 

=6 A9 or ASCII 


5 


S.ILP 


Print file (else punch) 


4 


S.IPMSG 


PM message waiting to be sent 


3 


S.IPMSNT 


PM message sent 


2 


S.IZ66 


66-bit end-of-line 


0-1 


S.IVCC 


V carriage control 

=00 No V detected 

=01 V detected; check for VC 

=10 V detected; no C 

=11 VC detected 




C.IDSXST(4) 


(for output file) 


1 


S.INEEDB 


Start next PRU with a blank 





S.IREADF 


READ.filename in progress 




C.IDSXST(4) 


(for output file) 


11 


S.IWAITX 


Wait-for-driver-stop 


10 


S.IWEQJ 


Wait-end-of-job 


9 


S.IHDR 


Send-header 


8 


S.IBAN 


No-banner 


7 


S.ISUP 


Suppress-carriage-control 


6 


S.IXNDLP 


First print end command flag 


5 


S.IEOL 


End-of-line 


4 


S.IOFF 


Request driver OFF/ON stream 


2 


S.IETX 


ETX sent 


1 


S.ISTOP 


Request driver stop stream 





S.IXABT 


Request driver abort stream 




C.IDSXST(4) 


(for input stream) 


11 


S.IWAITX 


Wait-for-driver-stop 


10 


S.IWEOJ 


Wait-end-of-job 


9 


S.IBIN 


Binary mode 


8 


S.IASC 


ASCII mode 
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NOTES: AUXILIARY USER TABLE (CONT'D) 



W.IDSXST(1) 

Bit 7 

5 
4 
3 
1 


W.IXININ(2) 

A Bit 11 



W.IFSTAT(2) 

Bit 



6-9 

5 
4 
3 
2 
1 




C.IDSXST(4) (for input stream) 

S.IJCER Error 

S.IXEOF End-of-file 

S.IOFF Request driver off stream 

S.IWPFC Wait PFC full 

S.ISTOP Request driver stop stream 

S.IXABT Request driver abort stream 

C.IBCNT(1) (for input stream only) 

(S.IETB) =1 ETB, =0 ETX sent 

C.IFSTAT(4) (for both input and output) 

S.IDSN Data stream number/site address 

S.IXABTI Abort issued 

S.IOFF Stream off 

S.INREDY Device not ready (mode 4) 

S.IETX ETX block sent 

S.ISTOP Stream stopped 

S.IXABT Stream aborted 
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HIGH SPEED AUXILIARY USER TABLE 



59 



47 



35 



23 



11 



W.IUSTA 



W.ICSTAT 



W.IDS1X 



C.IOST 



S.IDSO- 

Message 
Waiting - 

S.IDSI- 
Accept 
Message - 



C.IPST 



W.ICDIR 



65K321 



C.IUSID 
Terminal ID 



C.ISST 



65432 1 



C.ITST 



6543M1 



C.IBSTAT 
10 



C.IQST. 



Can Receive 

Input or Data 

Available 



Special 
Directive 
Received 



Cancel 

Special 

Directive 

or Release 

Data Stream 



Data Stream Word Pairs 



Latest Directive Block Received from Terminal 



Latest Status Sent to Terminal 



5|4|3|2|1 




15 



16 



17 



INPUT DATA STREAM WORD PAIR 



59 



47 



35 



C.IDINOT 



Data 
Stream OUT Pointer 



C.IFDC 
4 



23 



11 



C.IFNT 
FNT Address 



C.IDININ 



Data 
Stream IN Pointer 



C.IFSTAT 



input Suspended 

PFCFull-S.IWPFC 
—Job Card Error - S.IJCER 
—Job Card- S.IJCIP 
l-EOF-S.IXEOF 



C.IMXL 

Maximum Block 
Length 
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MULTI-USER JOB TABLE 



59 



47 



35 



29 



23 



11 



W.IUSTA 



W.IUCMD 



W.IMQP 



W.IUFST 



W.IMDES 



W.IMTIN 



W.IMTOUT 



C.INBUF 

Address of Next MUJ Table 



C.IMUC 
Total Number 
of MUJ Users 



C.IMAC 
Activity Count 



C.IUJDA 



MUJ JDT Address 



% 



W.IMNAME 



W.IINS 



C.IMED 
EDITOR Flag 



C.IMSID 
Swapin Delay 



C.IMTIP 



Address of TERMIN 



C.IMTOP 



C.IUSID 
MUJ ID 



C.ITIME 
1CI Timer for 
Swaps 



C.IUCCA 



1 



Address of 



Control Card Buffer 



C.IMSTAT 
MUJ Status Byte 



C.IMSIF 
Swapin Flag 



C.IMSOD 
.Swapout Delay 



C.IMTIL 
Length of 
TERMIN 



Address of TERMOUT 



C.IMTOL 

Length of 

TERMOUT 



C.IMFL 
MUJ FL/100B 



C.IBSTAT 
0005 



C.IMSOF 
Swapout Flag 



C.IUFILE 



C.IMTHDR 

Address of 

TERMIN/TERMOUT Header 



C.IMTHDR 

I Address of 

TERMIN/TERMOUT Header 



(Reserved for CDC) 



MUJ Name in Display Code 



(Reserved for Installation) 



W.IMQP(2) 



C.IMSTAT 



0001 = Waiting for I/O 
0003 = MUJ Active 

A S.IUCCP Control Cards moved to CPA Flag 



-End of 
Execution 



6 



7 



14 
15 

16 
17 
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274 INTERACTIVE GRAPHICS SYSTEM (IGS) USER TABLE 

_59 53 47 :__._ 3S 29 23 



W.IUSTA 



W.IUFST 



W.IINPUT 



W.IOTPUT 



W.IGFLGS 



W.IGHSU 
W.IUEQP 



W.IUGCAC 
W.IUGEF 

W.IUACP 



C.INBUF 



Address Next User Table 
in Chain 



C.IUSID 

User ID 



11. 



CIUCCA 
A 



Address of 
Control Card Buffer 



C.IUIDA 



Job Descriptor Addr, 



C.IDINOT 



Graphics Input Data 
Out Pointer 



C.IDOTOT 



Graphics Output Data 
Out Pointer 



C.IUCLAS 

Job Class Before 
Entering IGS Queue 



C.IDININ 



Graphics Input Data 

In Pointer 



C.IDOTIN 



Graphics Output Data 
In Pointer 



C.IUPORT 

EST I Port 
Ordinal 1 No, 



C.IGHSU 



Pointer to High 
Speed User Table 



C.IUACP 



Control Card Buffer 

Address 



CIUGCAC 

Console Access 



C.IBSTAT 

Flags 



7 
111 



C.IUGEF 

Error Flags 



C.IGFLGS 
Graphics Flags 



C.IUMSG 
10 



C.IUGEN 

Console No. 



10 



11 



12 



13 



14 



15 



16 



17 



NOTES: 274 IGS USER TABLE 



W.IGFLGS(6) 

Bit 5 
1 

2 


S.IG3TT 
S.IGQUE 
S.IGSNON 


CJGFLGS(4) 

3TT Interlock flag 

Job queued for first conslole flag 

SIGNON user table flag 


3 
9-11 


S.IGDRP 
S.IGCON 


IGS job termination flag 

Console No. for which job is queued 
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RECORD BLOCK TABLE ENTRY 

The RBT entries exist in the highest addresses of CM above the jobs running at control points. 
FILES RESIDENT ON PERMANENT FILE SETS 
FIRST RBT WORD PAIR (Type 4 - in CM) 

59 47 38 35 29 23 11 



C.RBTWPL 

Next Word Pair 


C.RBTDRB 
DAM 
Ordinal 


7 


C.RBTMST C.RBTAL 
MST Alloc. 
Ordinal Type 


C.RBTPRU 

Last PRU + 1 


CRBTBIT 

Flags 


C.RBTAUS 

PRUs/RB 


C.R8TVSN 

Volume Serial Number 


RB 7 



OTHER WORD PAIRS EXCEPT OVERFLOW 

59 47 38 35 



23 



11 



CRBTWPL 

Next Word Pair 


C.RBTDRB 
DAM 
Ordinal 





RB n 


RB 1 


RB 2 


RB 3 


RB 4 


RB 5 


RB 6 


RB 7 



OVERFLOW WORD PAIRS 
59 47 



38 35 



29 



23 



11 



C.RBTWPL 

Next Word Pair 


777 





C.RBTMST 
MST 
Ordinal 




End of Volume 
PRU + 1 


C.RBTODO 
DAM 
Ordinal 


C.RBTAUS 

PRUs/RB 


CRBTVSN 

Volume Serial Number 


00 



CRBTBIT 

11 10 9 8 7 6 5 4 3 2 1 



S.RBTDEV — Assigned by device type 
S.RBTRAC (Reserved) 
S.RBTPFD — PF device assigned 
S.RBTNEW- RBT new 
S.RBTOVF - Overflow 
S.RBTRND — Random 





. _j_ _i _i _i _|_ _i 


1 


L 















(Reserved) 

S.RBTPFC — File is cataloged 

S.RBTSYS — System device 

S.RBTQ — Queue device 

S.RBTVSN - VSN 

FO = IS/DA/AK - S.RBTSAM 
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RECORD BLOCK TABLE BYTE MINUS ONE 

COMPUTATION OF PHYSICAL ADDRESSES FOR DEFAULT ALLOCATION STYLES 



11 10 98765432 10 



6603 





z 


T t "T— "I 1 1 

Head Position 


1 
HG 


O/E 



6638 



— i 1 1 r — i— 

Head Position 


S 


r T i 

Head Group 


O/E 



854 



t — t — i — i — i — r — t— "T — r — r 

N 



821 



"i — i — i — r — i — r — i — i — i r 

N 



841 



~i — i — r- — i — i — i — i- — i — r- — r 

N 



844 



1 J 1 1 1 1 II 

c 


E 


— -, 

M 



Z Zone = Outer 

1 = Inner 

HG Head Group 

O/E Odd/Even = Even 
1 =Odd 

S Stack 

SG Subgroup 



60306500 H 



II-1-115 



COMPUTATION OF PHYSICAL ADDRESSES (CONT'D) 



821 



Cylinder 

Track 

Sector 



JN 
2 



if N is even 

1 if N is odd 



841 



844 



854 



Cylinder 
Track 

Sector 

Cylinder 

Track 

Sector 

Cylinder 

M 

S 

Track 

Sector 



5 



8* remainder of-— modulo 20 
5 

if remainder of -r- < 2 

5 

1 if remainder of — < 2 

o 

C 
114*M 



24 
E + remainder of 



114*M 
24 



(E = for even/E = 1 for odd) 

a 

13 



remainder of — 
13 



remainder of 

_S_ 
16 



M*24 
159 



remainder of — 
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SECTION 2 
JOB CONTROL POINT TABLES 



RA COMMUNICATION AREA 



59 



RA+0 

RA+1 
RA+2 

RA+53 
RA+54 

RA+63 
RA+64 
RA+65 
RA+66 
RA+67 
RA+70 

RA+76 

RA+77 

RA+100 
RA+1 11 



4 



M 



4 



35 29 23 17 



11 



SS 



User/System Interface 



Parameter 
(One per Word, Left Justified) 



(Reserved) 



Code 



* 



Yt 



1AJ Bootstrap for Absolute Programs 



Name/Library Name 



LWA+1 of Loadable 
Area in ECS 



FWA of Loadable 
Area in ECS 



JO 



Number of Parameter Words, 
Beginning in RA+2 



LWA+1 of Loadable 
Area in CM 



FWA of Loadable 
Area in CM 



Control Statement Image 
(Replaced by Operator Message If CFO Type-In) 



i 



FORTRAN 2.3 Execution FL 



FORTRAN 2.3 ASA Flag + = Non-ASA;-0 = ASA 



Loader Word 



User Program 
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NOTES: RA COMMUNICATION AREA 

r Job dependency recheck bit 

A Job swapout to operator action queue flag (l=job will be placed under operator action 

queue upon swapout regardless of job origin) 

O CFO flag (1 = accept comment from operator) 

T Storage move flag (1 = move being attempted) 

p Pause flag (1 = control point pausing) 

SS Sense switches 

CODE 00 = Continuation 

01 = Comma 

02 = Equals sign 

03 = Slash 

04 = Left parenthesis 

05 = Plus sign 

06 = Minus sign 
07* 

10 = Semi-colon 

11 = 

12 = 

13 = (reserved) 

14 = 

15 = 

16 = Other 

17 = Termination 

L Library/file flag (1 = name is library name) 

X XJ flag: if XJ = 1, and XJ can be issued 

C LDV completion flag (bit 29) 

D MS RSS flag (bit 18) 

M CMU Bit; if M=l and CMU can be issued 

JO Job origin: 

= System 

1 = Batch 

2 = Remote batch 

3 = Terminal 
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FILE ENVIRONMENT TABLE 



59 



63 



4/ 



41 



35 3? 29 



6RM- 
CPC- 



6RM- 

CPC 

6RM- 

CPC- 



23 



17 13 



LOGICAI FILE NAMF 



DEVICE TYPE 



M X 



DISPOSITION 
CODE 



FET 

LENGTH 

-5 



FNT POINTER 



RECORD BLOCK SIZE 



PRUSIZE 



LEVEL 
NO. 



ERROR 
CODE 



CODE 'STATUS 



FIRST POINTER 



IN POINTER 



OUT POINTER 



LIMIT POINTER 



XL-1 
XL-0 
XL-1 
XL-0 
XL-1 
XL-0 
XL-1 
XL-0 



Reserved for 6RM 



DETAIL 

ERROR CODE 

(XP-1) 



FWA 
WORKING STORAGE AREA 



POINTER TO 

FET EXTENSION 

(XP-1) 



UBC 



LWA+1 
WORKING STORAGE AREA 



MLRS (S/L TAPES ONLY) 



RECORD REQUEST/RETURN INFORMATION 
(RANDOM RMS ONLY) 



Reserved for 6RM 



RECORD NUMBER (CPCI 



SCOPE INDEX LENGTH 



FWA OF SCOPE INDEX 



6RM FET EXTENSION (XP-1) 



CPC EOI ADDRESS 



LABEL ERROR CODE 



LENGTH OF LABEL BUFFER 



CPC ERROR EXIT ADORESS 



FWA OF LABEL BUFFER 



FIRST 10 CHARACTERS OF FILE LABEL NAME 



(RESERVED) 



LAST 7 CHARACTERS OF FILE LABEL NAME 



POSITION NUMBER 



(RESERVED) 



EDITION NUMBER 



RETENTION CYCLE 



CREATION DATE 



(RESERVED) 



MULTI-FILE SET NAME 



REEL NUMBER 



10 



11 



12 



RESIDUAL SKIP COUNT 



PERM 
BITS 



LENGTH OF EXTENSION 

L 
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SCOPE CIO CODES IN OCTAL 

All codes are shown for coded mode operations; add 2 for binary mode. Example: 010 is coded READ, 012 
is binary READ. 



000 


RPHR 


004 


WPHR 


010 


READ 


014 


WRITE 


020 


READSKP 


024 


WRITER 


030 


- 


034 


WRITEF 


040 


BKSP 


044 


BKSPRU 


050 


REWIND 


054 


- 


060 


UNLOAD 


064 


- 


070 


RETURN 


074 


- 


100 


OPEN.NR 


104 


OPEN WRITE.NR 


no 


POSMF 


114 


EVICT 


120 


OPEN.NR 


124 


- 


130 


CLOSE.NR 


134 


- 


140 


OPEN 


144 


OPEN WRITE 


150 


CLOSE 


154 


- 


160 


OPEN 


164 


- 



170 


CLOSE.UNLOAD 


174 


CLOSE.RETURN 


200 


READC 


204 


WRITEC 


210 


READLS 


214 


REWRITE 


220 


- 


224 


REWRJTER 


230 


- 


234 


REWR1TEF 


240 


SKIPF 


244 


- 


250 


READNS 


254 


- 


260 


READN 


264 


WRITEN 


270-274 


- 


300 


OPEN.NR 


304-324 


- 


330 


CLOSER 


334 


- 


340 


OPEN 


350 


CLOSER 


354-364 


- 


370 


CLOSER.UNLOAD 


374 


CLOSER,RETURN 


400474 


- 


500-574 


Reserved for install* 


600 


Reserved for KROI* 


604-634 


- 


640 


SKIPB 


644-774 


. . 



II-2-4 



60306500 L 



LOCAL FILE NAMES 

The following list represents the reserved local file names that appear in a FET for the named 3.4 product 
set file. 



NAME 

ZZZZZ01 

ZZZZZ02 

ZZZZZ03 

ZZZZZ04 

ZZZZZ05 

ZZZZZ06 

ZZZZZ07 

ZZZZZ08 

ZZZZZ09 

ZZZZZ10 

ZZZZZ11 

ZZZZZ12 

ZZZZZ13 

ZZZZZ14 

ZZZZZ15 

ZZZZZ16 

ZZZZZ17 

ZZZZZ18 

ZZZZZ19 

ZZZZZ1A-1Z 

ZZZZZ20 

ZZZZZ21 

ZZZZZ22 

ZZZZZ23 

ZZZZZ24 

ZZZZZ25 

ZZZZZ26 

ZZZZZ27 

ZZZZZ28 

ZZZZZ29 

ZZZZZ2A-2Z 

ZZZZZ30 

ZZZZZ31 

ZZZZZ32 

ZZZZZ3A-3Z 

ZZZZZ41-49 

ZZZZZ50-59 



3.4 PRODUCT SET 

(EDITLIB) 
(EDITLIB) 
(EDITLIB) 
(EDITLIB) 
(EDITLIB) 
(EDITLIB) 
(EDITLIB) 
(EDITLIB) 
(DIAXNOS) 



(EDITLIB) 



(LOADER) 

(LOADER) 

(FORM) 

(SORT/MERGE) 

(FORM) 

(FORM) 

(6RM) 

(EDITLIB) 

(QUERY/UPDATE) 

(LOADER) 

(GRAPHICS) 

(LOADER) 

(DEBUGGING AIDS) 

(LOADO) 

(SORT/MERGE) 

(LOADER) 

(LOADER) 

(LOADER) 

(SORT/MERGE) 

(COBOL) 

(CDC reserved) 



USED FOR 

Reset file (permanent file) 
Restore file (permanent file) 
System extend file (permanent file) 
System file (permanent file) 
Interpreted directives 
ECS resident routines library file 
Entry point name table spill file 
Program number table spill file 

Program name table spill file 

External reference table spill file 

External reference collection spill file 

Library or deadstart program collection file 

Scratch 

PP program name table spill file 

Library name table spill file 

Entry point list 

Owned global blocks 



Memory manager 
Current directory file 

Global library set 

Overlay/segment generator 

ECS hold file 

SEGBILD scratch file (random) 
SEGBILD sort file (random) 
SEGBILD sort file (random) 
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LOCAL FILE NAMES (CONT'D) 



ZZZZZAA-A9 

ZZZZZBA-BO 

ZZZZZC3 

ZZZZZC4 

ZZZZZCB 

ZZZZZCC 

ZZZZZCD 

ZZZZZCP 

ZZZZZDB 

ZZZZZDD 

ZZZZZDF 

ZZZZZDM 

ZZZZZEF 

ZZZZZFC 

ZZZZZI1 

ZZZZZI2 

ZZZZZIN 

ZZZZZL1-L9 

ZZZZZOP 

ZZZZZOU 

ZZZZZQU 

ZZZZZQ1-Q6 

ZZZZZPA 

ZZZZZPB 

ZZZZZPC 

ZZZZZPD 

ZZZZZPE 

ZZZZZPF 

ZZZZZPG 

ZZZZZPK 

ZZZZZPT 

ZZZZZPW 

ZZZZZRE 

ZZZZZRL 

ZZZZZRM 

ZZZZZRN 

ZZZZZSA-SD 

ZZZZZSE 

ZZZZZSF 

ZZZZZSG 

ZZZZZSH 

ZZZZZUN 

ZZZZZVx-Zx 

ZZZZECS 



(Index Processor) 

(Index Processor) 

(CDC Special Systems) 

(CDC Special Systems) 

(DDL) 

(DDL) 

(DDL) 

(INTERCOM) 

COBOL Debug File 

(System Dynamic Dump) 

(6RM/LOADER) 

(SCOPE) 

(6RM) 

(FTN4) 

(ALGOL) 

(ALGOL) 

(INTERCOM Utility/QU) 

(LDCMR) 

(FTN4/COMPASS) 

(INTERCOM Utility/QU) 

(QUERY/UPDATE) 

(QUERY/UPDATE) 

(PFM) 

(PFM) 

(PFM) 

(PFM) 

(PFM) 

(PFM) 

(PFM) 

(MMF-PFM) 

(PFM) 

(PFM) 

(INTERCOM) 

(FTN4/COMPASS) 

(FTN4/COMPASS) 

(PAGE Utility) 

(SIFT) 

(EDITOR) 

(EDITOR) 

(EDITOR) 

(EDITOR) 

(INTERCOM) 

(Installations) 

EDITLIB 



Scratch file 
Scratch file 
Scratch file 
Copy permanent files 

Core image dump file 

File control card processor 

FNT used by SPM to access DAM 

Error message file 

Symbolic object code file 

Scratch file 

Scratch file 

Connected files 

Scratch files 

Connected files 



Scratch file 

Scratch file 

Attached RBTC 

Attached PFD 

Reserved 

Attached PF 

Reserved 

Multimainframe packet file 

PF dump tape 

Attached PF DUM 

Restricted passwords 



Interim random page file 



Unrestricted passwords 

System ECS resident library creation job 
(permanent file) 
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ENTRY POINT NAMES 



AGxxxxx 


1 


ALGOL 


ALxxxxx 


/ 




ATxxxxx 




APT 


BAxxxxx 




BASIC 


CBxxxxx 
COxxxxx 


} 


COBOL 


CPxxxxx 




COMPASS 


D.xxxxx 




COBOL 


DIxxxxx 




CE Diagnostics 


EBxxxxx 




8231 IMPORT 


ECxxxxx 




EXPORT IMPORT 200 


EHxxxxx 




6000 EXPORT Highspeed 


FExxxxx 
FXxxxxx 


} 


FORTRAN Extended 


FMxxxxx 




FORM 


FTxxxxx 




RUN 


G6xxxxx 




IGS/6000 EXPORT HS 


G7xxxxx 




IGS/1700 IMPORT 


INxxxxx 




INTERCOM 


IXxxxxx 




Index Processor 


ISxxxxx 




SIS 1.0 


ITxxxxx 




INTERCOM 


I7xxxxx 




1700 IMPORT HS 


I8xxxxx 




8231 IMPORT HS 


JVxxxxx 




JOVIAL 


MIxxxxx 




1700 MSOS IMPORT HS 


MRxxxxx 




MARS VI 


OHxxxxx 




OPHELIE 


OPxxxxx 
OTxxxxx 


} 


OPTIMA 


PLxxxxx 




PL1 


PTxxxxx 




PERT/TIME 


QUxxxxx 




QUERY UPDATE 


RMxxxxx 




6RM 


SCxxxxx 




SCOPE 


SIxxxxx 




SIMSCRIPT 


SMxxxxx 
SOxxxxx 


} 


SORT/MERGE 


SSxxxxx 




SIMSCRIPT 


SUxxxxx 




SIMULA 


Uxxxxxx 


1 




Vxxxxxx 


/ 




Wxxxxxx 


I 


Reserved for Installation 


Xxxxxxx 


( 




Yxxxxxx 






Zxxxxxx 


) 
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FET CODES 

WORD - Error Codes 

01 End of information 

02 End of reel 
04 Parity error 

10 Device capacity exceeded 

1 1 Implicit MOUNT inhibited 

20 Additional error status returned 

21 End of multi-file set 

22 Fatal error 

23 Index buffer full 

24 Interlock broken for shared RMS 

25 Index full on random read/write of record n 

26 Nonexistent record named on random read 

27 Nonexistent record named on random write and index is full 

30 Function undefined on device 

31 Permission not granted 

32 Function illegal on permanent file 

133 No public set has required attributes 
34-37 Reserved 



WORD 1 - Meaning if bit is set 



Bit 



47 


(R) 


46 




45 


(UP) 


44 


(EP) 


43 




42 


(IN) 


41 


(XL) 


40 


(XP) 


39 


(EC) 


38 


(NS) 


37 


(IIM) 



Process SCOPE index if OPEN/CLOSE; else random read/write 

Reserved 

User processing at end of volume 

User processing on error condition 

Reserved 

INTERCOM (multi-user job or graphics) 

Extended label processing 

Extended error processing 

Disallow automatic allocation of ECS buffer 

File has non-standard labels; processing of label records is left to user 

Inhibit implicit MOUNT 
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WORD 6 

Detail Error Codes (bits 48-59) 

When the XP bit is set to 1, this field contains extended tape error processing codes which give additional 
detail of abnormal conditions resulting from the last input/output operation. The user is responsible for 
clearing this field after reading it. 

Codes 1-77 (octal) are considered software warnings to the user; they are not results of hardware failures. 
The tape related codes and subsequent software warnings are as follows: 

Error Codes 

(Octal) Software Warning 

24 Read error in opposite mode 

25 Function not complete 
27 Record fragment possible 

30 Data read exceeds MLRS/PRU size 

31 Multi-file set ill-formed 

32 Write attempt on protected volume 

33 Write at 200 bpi not allowed on 66x tape drive 

35 Multi-file name not found on multi-file device 

36 Next volume unknown 

37 File not allowed on assigned device 

Codes 100-177 (octal) are considered cases where the tape unit has lost position. These codes are as follows: 

Error Codes 

(Octal) Position 

100 Position uncertain - data intact 

101 Position uncertain — data destroyed 

102 Physical/logical positions disagree 

103 Position uncertain - ready dropped during last operation 

Codes 200-277 (octal) are considered unit oriented errors. Switching physical tape devices allows the program 
to continue after repositioning. These codes and subsequent errors are as follows: 

Error Codes 

(Octal) Unit 

200 System error - tape table 

201 Hardware - unit hung busy 

202 Hardware - no end of operation 

203 Hardware density change during I/O 

204 Unit reserved by another buffer controller 

205 Loop fault 

206 Unable to read tape label just written 

207 Marginal transport indication 

210 Lost data 

211 Multiple load points on tape 

212 No read after write 

213 Coldstart 

214 Irrecoverable write reposition error 
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Codes 400-477 (octal) are errors resulting from hardware failure between the PPU and the physical tape unit. 
These codes and subsequent errors are as follows: 



Error Code 
(Octal) 

400 
401 

402 
403 
404 



Data Path Error 

Hardware - 668x malfunction 
Hardware — MMTC memory parity error 

Hardware - 6681 failed, no data on IAN 
Hardware - transmission parity error 
System error 



Codes 1000-1005 (octal) are errors resulting from a bad tape. These codes and subsequent errors are as follows: 



Error Codes 




(Octal) 


Tape (Medium) 


1000 


Tape parity error 


1001 


25 feet erased tape 


1002 


Blank tape read 


1003 


Incomplete erasure of tape bad spot 


1004 


Noise in IRG 


1005 


Erase limit reached 



Codes 6000-7777 (octal) are reserved for installations. 



Codes are combined meanings of the following bits: 



11 10 


9 


8 


7 


6 


5 


4 


3 


2 


1 





Reserved 

I 


TM 


CE 


UE 


PL 


DE 


DE 


DE 


DE 


DE 


DE 



TM Tape medium 

CE Controller error (controller, 6681, etc.) 

UE Unit caused error 

PL Position lost 

DE Detailed error 

The references to system noise record and last good record refer to procedures the system follows in recovery 
attempts. 

Detailed error codes allow a central processor program to take appropriate action when a non-user caused error 
occurs. For example, the message UBC IN FET TOO LARGE does not have a detailed error code because -it 
is a user caused error. On the other hand, the message TAPE PARITY ERROR is assigned to a detailed error 
code becauser the condition is an externally caused error. 
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FET CODES (CONT'D) 
WORD 6 - Error Codes (cont.d) 

Hardware Malfunction 

0050 MMTC memory parity error 

0051 Transmission parity error 

Position Uncertain 

0100 Valid data probably destroyed - highly unlikely that a close will be successful 

0101 Valid data probably intact - likely that a close will be successful 
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FILE INFORMATION TABLE 



59 








53 


47 








41 






35 










29 








23 






17 




11 5 




LFN 
Logical File Name 


Reserved 





RL 
Current Record Length 


P 
M 


FO 


N 

X 


BT 


i° 


RT 




K 

1 


PO 


FDT 

File Description Table 


1 


FET 

FET Address 


PTL 

Partial Transfer Length 


OF 


VF 


CF 


LT 


ULP 


FP 


LX 
Address of Label Routine 


2 


HL 

Header Length of T Record 

MNR 

Minimum Record Length 


BFS 
Buffer Size (in Words) 


DX 
Address of End-of-Data Routine 


3 


TL 
Trailer Length of T Record 


FIP 
N E 
F1F 




SES 


IRS 


EX 
Address of Error Routine 


4 






ES 
Error Status 


VNO 


ECT 
Error Count 


ERL 
Error Limit 


F 

P 
B 


S 
V 




S 
P 
R 


E 
X 
D 


S 



s 


f 

oc w N 


L 
C 
R 


K 

N 


H 

B 


LVL 


FW8 

FWA of User Buffer 


5 




Hit. 


FL 

Length of F/Z Record 

MRL 

Maximum Record Length 


Reserved 


C 

M 


60 


WSA (WSAL) 
FWA of Working Storage Area 


6 


KP 


XL 
Key Length 


MKL 
Major Key Length 


RKP | RKW 


PNA (PNAL) Addr. of Partition Name 




i IP | DP 


KA Key Address 


7 


MFN Multi-file Name f PNO Multifile Position Number 




MNB 
Minimum Block Length 


RMK 

Record Mark 

Character 


PC 


LA 
FWA of Label Area 


8 


KT 


LP 
BCP of D Record Length Field 


R8 
No. of Records in K Block 


PAR 
Parameter List Address 


9 


CP 

BCP of T Record Trailer Count Field 


P 
D 
F 


S 

B 

F 


ic 

Reserved N 


S 

a 


c 
1 


LL 


W 


LOP 


RC 

Record Count 


10 


CL 


N 




LBL 
Length of Label Area 


MUL 


BN 
Current Block Number 


11 




TRC 


ECL 
Error Code Location 


MBL 
Maximum Block Length 


NL 



V 
F 




DL 




' ■ ; FLM 


12 




Reserved for Record Manager 


IBL 
Index Block Length 


WAC 

Word Address 

Char. Pos, 


WA 
Current Word Address 


13 


Reserved for Installation 


14 


HMB 
Number of Home Blocks 


Reserved 


HRL 
Address of Key Hashing Routine 


15 




CDT 


OCT 


XN 
Index Fit* Nam* 




R»a 
for 
Kl 


KR 
Key Repeat 


16 


Reserved wee Record Manager 


17 



Figure 3-1. File Information Table 
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NOTES: FIT 

The following fields are explained as they apply to- CYBER Record Manager under SCOPE 3.4. 

FIT TABLE 
Word 

59-18 LFN Logical file name 

17-0 Reserved for Record Manager 

Word 1 

59-36 RL Current record length in number of characters 

If RL=1, for multiple index file, position file only 

35 PM Processing mode (Record Manager only) 

= random 

1 * sequential 

34-32 FO File organization 

000 sequential (SQ) default 

001 word addressable (WA) 
011 indexed sequential (IS) 
101 direct access (DA) 
110 actual key (AK) 

31 NDX Index flag 

= data file is accessed • 

1 - index file is accessed 

30-28 BT Blocking type 

000 default/internal (I) 

001 internal (I) 

. . 010 character count (C) 

011 record count (K) 
100 exact records (E) 

27 BCK Block checksum flag 

- no checksums 

1 = checksums 

26 Unused 
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NOTES: FIT (CONT'D) 
25-22 RT 



21 



DKI 



20-18 



PD 



17-0 
Word 2 
59-36 

35-34 



FET 



PTL 



OF 



33-32 



VF 



Record type 

0000 control word (W) 

0001 fixed length (F) 

0010 record mark (R) 

0011 zero byte (Z) 

100 decimal character count (D) 

0101 trailer count (T) 
0111 undefined (U) 

1000 System logical records (S) 

Duplicate key indicator; indicates duplicate key 
permission on an IS file 

no 

1 yes 

Processing direction 

000 input (INPUT) 

001 input (INPUT) 

010 output (OUTPUT) 

1 1 input/output (I/O) 

Pointer to FET 



Partial transfer length, set by GETP, PUTP macros. 
Number of keys moved to WSA for a GET or 
GETN on an alternate key index. 

Open flags (positioning of file at OPENM time) 

00 rewind (R) 

01 rewind (R) 

10 no rewind (N) 

1 1 extend (E) 

End of volume flags (positioning of file at volume 
CLOSEM time) 

00 unload (default) 

01 rewind (R) 

10 no rewind (N) 

11 unload (U) 
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NOTES: FIT (CONT'D) 
31-30 CF 



29-28 



LT 



27-25 



ULP 



24-18 



FP 



17-0 
Word 3 

59-36 



35-18 
17-0 



LX 

HL 

MNR 

BFS 

DX 



Close flags (position at file close) 

00 Rewind (R) 

01 Rewind (R) 

10 No rewind (N) 

11 Unload (U) 

Label type 

00 ANSI standard (S) 

01 Non-standard (NS) 

10 Unlabeled (UL) 

11 Any (ANY) 

User label processing 

000 None 

001 VOL/EOV (V) 

010 HDR/EOF (F) 

011 VOL/HDR/EOV/EOF (VF) 

100 UVL/UHL/UTL (U) 

101 VOL/UHL/UVL/EOV/UTL (VU) 

1 1 HDR/UVL/EOF/UHL/UTL (FU) 

111 All (VFU) 



File position 
000 Mid-record 

End of label group or beginning of 

information (EOL/BOI) 

Beginning of file/volume (BQF/BOV) 

(only set on SKIPBu in connection 

with DX) 

End of volume (EOV) 

End of section (EOS) 

End of record (EOR) 

End of partition (EOP) 

End of information (EOI) 



001 



002 



004 
010 
020 
040 
100 



Label routine address 

Character length of fixed header of a type T 
record 

Minimum character length of type R record 

CIO buffer size (number of words) 

End of data routine address 
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NOTES: 


FIT (CONT'D) 


Word 4 




59-36 


TL 


35 


FNF 


34 


PEF 


33-31 




30-27 


SES 



26-18 

17-0 
Word S 

59-54 

53-45 

44-36 

35 

34 

33 
32 



31 



IRS/ES 
EX 

VNO 

ECT 

ERL 

FPB 

SVO 

SPR 
EXD 

SDS 



Character length of trailer portion of type T records 
Fatal/non-fatal flag (1 = fatal) 
Parity error flag (1 = parity error) 
Reserved 

System error sub field 

01 Read parity error level 1 

02 Read parity error level 2 

03 Read parity error level 3 

04 Read parity error level 4 

05 Write parity error level 1 

06 Write parity eiror level 2 

Invalid request sub field (CYBER Record Manager/ 
octal error status error code) 

Error Routine address 



Current volume number of multi-volume sequential file 

Current trivial error count 

Trivial error limit 

File position bit (for user use) 

Indicates IS version 2 user 

1 Indicates IS version 1 user 

Suppress read ahead 

Read ahead/write behind (buffered sequential I/O) 

1 No read ahead/no write behind 

Extended diagnostic flag 

No detailed explanation 

1 More detailed diagnostics are produced on the 
file ZZZZZEF 

System message disposition 

For SQ and WA files, all error messages are 

written on the system error file, ZZZZZEF. 

Fatal errors are written on the job dayfile (NO) 

For IS, DA and AK files all messages and file 
statistics are written on the system error file 
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NOTES: FIT (CONT'D) 



30-29 

28 

27 
26 

25 

24 

23-21 
20-18 



17-0 
Word 6 
59-36 

35-26 



OC 

FWI 

ON 
LCR 

KNE 

HB 

LVL 
REL 



FWB 

MRL 
FL 



1 For SQ and WA files, error messages appear on 
the job dayfile as well as ZZZZZEF (YES) 

For IS, DA and AK files, all nonfatal messages 
are written on ZZZZZEF, and file statistics 
are written on the job dayfile. 

Open/close 

00 never opened 

01 opened 
10 closed 

Forced write indicator for IS, AK, and DA file blocks | 

no forced write (NO) 

1 forced write (YES) 

Old/new IS, DA, or AK file (1 = new-creation run) i 

(0 = old) ■ 

Label action on PD tape (PD = I/O) 

create new labels (N) 

1 check existing labels (E) 

Key not equal (multiple-index file) 

key match 

1 no key match found 

User header option AK files 

do not return header 

1 return header (default) 

Level number of an EOS 



File position key relation (IS files) 



1 


EQ 


equal 


2 


LE 


less than or equal 


3 


GE 


greater than or equal 


4 


NE 


not equal 


5 


LT 


less than 


6 


GT 


greater than 



First word address of user I/O buffer 

Maximum record length in characters 
Length of an F or Z type record (characters) 
(Reserved for CDC) 
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NOTES: FIT (CONT'D) 

25 CM 



24-22 



21-0 

Word 7 
59-56 

55-47 



46-38 
37-34 

33-22 

35-29 

28-22 

21-0 

59-24 

23-0 

Word 8 

59-36 
35-28 



EO 



WSA 



KP 



KL 



MKL 
RKP 

RKW 

IP 

DP 

KA 

MFN 

PNO 

MNB 
RMK 



Conversion mode 

1 convert from EC to IC (YES) 

no conversion (NO) 

Error options 

000 terminate file (T) 

001 drop erroneous data (D) 

010 accept erroneous data (A) 

1 1 (unused) 

100 display data and terminate file (TD) 

101 drop and display data (DD) 

1 10 accept and display erroneous data (AD) 

1 1 1 (unused) 

First word address of user work storage area (user 
record area) 



Starting character position of record locator key 
(IS, DA files) specified in KA 

Length of key in characters (IS, DA files) 
Length of key in bits (AK files) 
Length of primary or alternate key in bits prior to 
open of new multiple index file; after open, length 
in characters (AK files) 

Major key length in characters (IS files) 

Relative key position in RKW (DA files or alternate 
key IS, DA, or AK files) 

Relative key word position (DA files or alternate key 
IS, DA, or AK files) 

Index block padding percent (IS files) 
Data block padding percent (IS, AK files) 
Address of record locator keys (key field address) 

Multi-file name 

Multi-file position number 



Minimum block length in characters 
Record mark character 
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NOTES: FIT (CONT'D) 
27-22 PC 

KT 



21-0 
Word 9 

59-36 



35-22 

21-0 
Word 10 

59 

58 

57-45 

44 

43 

42 

41-36 

41-36 



LA 

CP 
LP 
RB 

PAR 

PDF 

SBF 

Reserved (CDC) 

CNF 

SB 

CI 
LL 
CL 



Padding character for sequential file blocks 

Key type for indexed sequential files (octal) 

00 symbolic (S) 

01 symbolic (S) 

02 integer (I) 

03 floating (F) 

04 computational-! 
06 computational-2 

07-77 reserved for CDC use 

First word address of user's label area 



Beginning character position of trailer count field 
(type T record) (numbered from zero) 

Beginning character position of record length field 
(type D record) (numbered from zero) 

Number of records per K type block in SQ files; 
records per block in AK file; average number of 
records for IS or DA file 

Reserved 



Set by SETFIT, cleared by open 
1 if suppressed buffer I/O 

File is connected to terminal if 1 

For D-type records, length field has sign overpunch. 
For T-type records, the trailer count field has sign 
overpunch 

For D-type records, length field is binary 

For T-type records, trailer count field is binary 

Length in characters of record length field (type D 
record) 

Length in characters of record trailer count field 
(type T record) 
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NOTES: FIT (CONT'D) 



35-30 



LOP 



35 



29-0 



WPN 



RC 



Last operation code (the high order bit of LOP is write bit, indicating 
whether or not the last operation wrote data to the file). 



01 OPENM (OP) 13 

02 CLOSEM (CM) 43 

03 GET or GETP (GE) 44 

04 SEEK (SE) 46 

05 SKIP (SK) or SKIPF (SF) 47 
07 GETN (GN) 56 

10 REWIND (RE) 63 

11 GETL (GL) or PUTL (PL) 77 

12 SKIPB (SB) 



CLOSEL (CL) 
PUT or PUTP (PU) 
REPLACE (RP) 
DELETE (DE) 
WEOR (WE) 
REPLACE (RP) 
WTMK (WK) 
ENDFILE (EN) 



Write bit. The upper bit of LOP is a one-bit subfield that can be ac- 
cessed separately; it is set if the last operation was a write. 

Record count. Count of full records read or written since the file was 
opened. Count is not adjusted for repositioning backspacing operations. 
For multiple-index file, number of records with this key. 



Word 11 

59-36 

35-30 

29-0 

23-18 



| 1-7-0 



LBL 
MUL 
BN 
TRC 

ECL 



Length of user's label area (number of characters) 
Multiple of characters per K, E type block 
Block number of current block (SQ files) 

Number of transactions to be traced (IS or DA 
files) 

Error code location (address of error code) 



Word 12 

59-36 

35-30 
29-28 



27-0 
17-0 



MBL 

NL 
OVF 



FLM 
PRS 



Maximum block length. MBL is submitted in 
characters but converted and maintained in words 

Number of index block levels (IS files) 

DA file overflow 

01 overflow blocks only (OVO) 

10 either overflow or home block (OVB) 

1 1 home blocks only (OVH) 

File limit in number of records per file (IS/DA/AK) 

Previous record length after a forward sequential 
GET, FO=SQ and RT=W 
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NOTES: FIT (CONT'D) 
Word 13 

59-36 IBL 



35-30 
29-0 



WAC 

WA 



Word 14 Reserved for users 
Word 15 

59-30 HMB 

21-0 HRL 

51-30 CDT 



21-0 

Word 16 

59-18 

17-15 
14-12 
11-0 

Word 17 
59-0 



DCT 



XN 



KR 



Index block length (characters) 

Word address character position 

Current position word address set by GET, 
PUT, GETP, and PUTP macros 



Number of home blocks of a DA file 

Address of key hashing routine for a DA file 

Collating sequence to display code conversion table 
address for IS file 

Address if display code to collating sequence conver- 
sion table address for IS file 



Name of index file assocaited with mutiple- 
index file 

Unused 

Reserved for KI 

Number of times key value repeats in current 
record of multiple-index file 



Scratch area used by CDC CYBER Record Manager 
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FILE DEFINITION BLOCK 

59 



17 



118 5 



Permanent File Name 
(Left Justified Binary Zero Filled) 



Logical File Name (Left Justified, Binary Zero Filled) 



Return 
Code 



Parameter Value (Right Justified, Binary Zero Filled) t 



Additional Parameter Value 



Unused 



NR (Bit 8) 

1 = NR option specified; no automatic recall 

RC (Bits 7-6) 

01 = No RC or RT specified 

00 = RC option specified 

10 = RT option specified (implies RC as well) 



FC (Bits 5-2) Function Code 

0001 = SETP 
0010 = ATTACH.GETPF 
0100 = CATALOG.SAVEPF 
0110 = EXTEND 

C (Bit 0) Complete Bit 

1 = Function completed 



0111 = ALTER 

1000 = PURGE,PURGE(ST=xxx) 

1010 = RENAME 

1100 = PERM 



RC 



FC 



Key 
Word 



Key 
Word 



Key 
Word 



OOOOtt 



flf VSN (keyword 41) is specified, a 6-character volume serial number is contained in bits 59-24, right- 
justified, display code zero filled. 
ffThe system checks only bits through 11 of this word. 
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NOTES: FILE DEFINITION BLOCK 



Return code (Bits 17-9 of word 4) and message written to the job dayfile 



000 


Function successful 


035 


001 


ID error 


040 


002 


lfn already in use 


041 


003 


Unknown lfn 


042 


004 


No room for extra cycle (limit is five) 


070 


005 


PFC Full 


071 


006 


No lfn or pfn 


072 


010 


Latest index not written for a random file 


073 


011 


File not on PF device 


074 


012 


File not cataloged, SN=xxxxxxx 




013 


Archive retrieval aborted 




014 


Bad LPF communication 




015 


Cycle number limit reached. Maximum value 
of cycle number is 999 




016 


PFD Full 




017 


Function attempted on nonpermanent file 




020 


Function attempted on nonlocal file 




022 


File never assigned to a device 




023 


Cycle incomplete or dumped 




024 


PF already attached 




025 


File unavailable 




027 


Illegal lfn 




030 


File dumped 




031 


Illegal function code 




033 


ALTER needs exclusive access 





Key Word (Bits 5-0 of any parameter word) and parameter value 

01 PP -Privacy Procedure PP name 20 

02 RP -Retention Period (days) (binary) 21 

03 CY -Cycle Number (binary) 22 

04 TK -Turnkey Password Definition (display) 23 

05 CN -Control Password Definition (display) 24 , 

06 MD —Modify Password Definition (display) 25 

07 EX -Extend Password Definition (display) 26 

10 RD -Read Password Definition (display) 30 

11 MR -Multi-Read Parameter (binary) 31 

12 SD -Reserved 32 

13 XR -Control, Modify, Extend Password 33 

Definition (display) 40 

14 ID -Owner-Identification (display) 41 

15 RN -Reserved 43 

16 AC -Account Parameter (display) 

17 EC -ECS Buffering (display) 



File already in system 

Illegal setname specified 

Device set not mounted at control point 

RBT chain too large for PFC 

PFM stopped by system 

Incorrect permission 

FDB address error 

I/Oerror on PFD/PFC read/write 

ST illegal with user set (MMF-PURGE) 



PW -Passwords submitted 



FO -File Organization (display) 

PS -Position 

PF —Permanent File Name 

LC -Lowest Cycle (binary) 

ST -Staging ID (display) 

RW —Multi-Access Rewrite (binary) 

SN -Setname (display left-justified) 

Reserved for VSN parameter 
RB — RB conflict on Permanent File 
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REQ FUNCTION PARAMETER LIST 
59 47 35 



23 



17 



11 



Logical File Name 



MA 



EST Ordinal 



Device Type 
and Alloc. Style 



Volume Serial Number 



(Reserved for 
Preallocation) 



SET NAME 



ECS Units 
(P or K) 



ECS Buffer 
Size 



t 



Tape File Header Label Fields 



g 



Bits 59-57 
56 

55 (Q) 

54 (IB) 

53 (NORING) 

52 (RING) 

51 (MN) 

50 (A*) 

49 (EL) 

48 (NL) 
35 
34 

33 (EC) 

32 (OV) 

31 (PF) 

30 (US) 

29 (EB) 
28 

27 (SY) 
26 

25 (VSN) 

24 (EN) 

23 (NS) 

22 (NR) 

21 (Z) 
20 

19 (CI) 

18 (MF) 

17 (SN) 
16 

15 (DD) 

14 (SV) 

13 (IU) 

12 (CK) 



Reserved 

= assign file to system device in system set 

= assign file to queue device (in queue set if no (SN) given) 

= inhibit system- noise records if IP.NBRK=0 

= write enable ring prohibited in tape 

= write enable ring required in tape 

= accept either MT or NT assignment 

= assign any RMS device (overrides device type specification) 

= extended label fields in parameter words 5-9 

= normal label fields in parameter words 5-8 
Reserved 
Reserved 

= ECS buffering requested; parameter word 4 

= allow overflow to a different device 

= assign file to a PF device 

= ASCII conversion mode on 9-track tape 

= EBCDIC conversion mode on 9-track tape 

= assign automaticallyt 

= print card image from RA+70 

= assign 2 devices 

= VSN declared in parameter word 3 

= tape has existing labels 

= tape has non-standard labels 

= disable standard tape parity recovery procedure 

= SCOPE 33 labeled tape 

= return error code without dayfile message or operator intervention 

= console checkpoint request 

= multi-user tape request 

= set name request 
Reserved 

= default density for labels and data 

= save tape 

= inhibit physical unload 

= checkpoint tape 



tAn * preceding a parameter will cause automatic assignment. 
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NORMAL LABEL FIELDS 



59 


47 


29 


23 


17 









Position Number 


Edition Number 


Retention Cycle 




Creation Date (YYDDD) 




Multi-File Set Name 


Reel Number 



EXTENDED LABEL FIELDS 



59 


53 




35 


29 




17 


5 


H D 


R 1 






File 
Label 
Name 


Multi-File Set Name 


Reel Number 


Reel 
Number 


Position Number 


Generation Number 


Edition 
Number 


Edition 
Number 


Creation Date (A YYDDD) 
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SUBCHANNEL TABLE (SCHT) 

The SCHT is used by the CDC CYBER Enhanced Station in a multi-mainframe configuration. The SCHT 
consists of two parts, the header and word 1 entries that represent data or message subchannels. This table 
resides within the field length of the station. Its purpose is to coordinate the transmission/reception of data 
or messages, to or from the linked mainframe, between the SPOT, STD, and MFSTAT. Word 2 of the 
header is a communications word between STD and MFSTAT. Word 3 of the header is a communications 
word between STD and ICC. 



59 



23 



17 



11 



WORD 



SCHT 
HEADER 





CPHDL 


CPEST 


CPBLL 




CPMBL 


STD/MFSTAT COMMUNICATIONS WORD 


STD/1CC COMMUNICATION WORD 















DATA SUBCHANNEL OR 
MSG SUBCHANNEL ENTRIES 



% 



102 
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NOTES: SUBCHANNEL TABLE 



Field 
WordO 

23-18 

17-12 

11-0 

Word 1 

11-0 

Word 2 

59-54 

52-48 

Word 3 

59-54 

58 

53-48 

47-36 

17-0 



Field Name 

CPHDL 

CPEST 

CPBLL 

CPMBL 

CPRCD 
CPRSC 

PPRCD 
PPBUS 
PPRSC 
PPRCP 
PPRFT 



Word 4-102 Data and message subchannel entries 
59 LMTTY 



58 
58 

57 



LMTSB 
LMTDR 

LMTAK 



57 


LMTEI 


57 


LMTCK 


60306500 F 





Description 

SCHT header size minus 4 

EST ordinal 

Current standard buffer size 

Maximum standard buffer size 

Request code (station only) 
Subchannel number 

Request code 
Request word busy 
Subchannel busy 
Control point number 
FET address 



Subchannel type 
1 = data 

= message 

Indicates transmit buffer full 

1 = receive data subchannel 
= transmit data subchannel 

Indicates transmit buffer full and acknowledge 
expected 

Send end-of-information 

Try to request more data 
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NOTES: SUBCHANNEL TABLE (CONT'D) 



56 

56 

55 

54 

52^8 

47-36 

35-18 

35-18 

17-0 

17-0 



LMTCN 
LMTRB 
LMTUX 
LMTEX 
LMTCP 
LMTRL 
LMTRC 
LMTRF 
LMTSF 
LMTFT 



End-of-information sent 
Indicate receive buffer full 
Unexpected data 
Excess data 

Control point of spun off task 
Receive message buffer length 
Receive word count (data subchannel) 
Receive message buffer address 
Transmit message buffer address 
FET address 



SPOT NAME TABLE (SNT) 

The SNT is used by the CDC CYBER Enhanced Station in a multi-mainframe configuration. The SNT 
consists of two-word entries that reside within the field length of the station. For each spun off task 
(SPOT) there is one entry with the name of the task in the first word of the entry. Its chief purpose 
is communications between the task and the station, in which ICC acts as the communicator for the 
task. The opening, closing and backspacing of the staged file is coordinated through the SNT. Routines 
that access this table are INS, ICC, MFSTAT, and DSD. 



59 



47 



41 



35 



23 



17 



SNLFN 



FLAGS 



SNSCN 



FLAGS 



SNSFT 



SNPCK 



SUBSEQUENT 2-WORD ENTRIES 



SNCMP 



11 



SNERR 



SNPPR 
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NOTES: SPOT NAME TABLE 

Field Field Name 

Word 

59-18 SNLFN 



6-17 
00 



59 
58 
57 
56 
55 

54 

53 

52 
51 
49 
49 

48 

47-42 
60306500 F 



SNERR 
SNCMP 



SNIIN 

SNOIN 

SNCLO 

SNOPN 

SNFLK 

SNBKS 

SNBUS 

SNDOP 
SNFIN 
SNRFL 
SNSPR 

SNRWI 

SNSCN 



Description 



Name of spun off task; is mnnnncc. m is the 
identifying character of linked mainframe, and n's 
are the job ordinal on mainframe m. cc are arbitrary 
characters assigned by the station 

1EJ error return code 

Complete indicator set to when task is spun off, 
and set to 1 when IEJ goes through end-of-job 
processing 



Operation for spooled input file 

Operation for spooled output file 

File close operation 

File open operation 

File linkup chores are in progress, or complete 
(if e is 0) 

Backspace operation (for end-of-volume tape stage 
processing). When this bit is set, bits 17-00 con- 
tain backspace word count 

ICC busy bit; if on, open, close, or backspace 
operation is in progress (set and cleared by ICC 
only) 

Open procedure for the task dayfile is complete 

Dayfile transfer completed 

Buffer space obtained for dayfile transmission 

A request made to linked mainframe to stage a 
spooled file 

File direction 

= transmit 

1 - receive 

Subchannel number to be used for file I/O 
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NOTES: SPOT NAME TABLE (CONT'D) 
41 SNIOR 

41 SNDRM 

40 SNODD 



40 

40 
39 
39 

38-36 



35-24 

23-12 

17-0 

17-0 

11-0 

Word 2 



SNCAN 

SNIOD 
SNIOL 

SNCNT 

SNSAT 



SNSFT 
SNPCK 
SNPRU 
SNDBF 
SNPPR 

ENTRY 



I/O request message received from linked mainframe 

File is random 

Deadstart or dump request received and file can be 
opened 

Linked mainframe can receive or transmit a spooled 
file 

I/O delink transmitted to linked mainframe 

I/O linkup transmitted to linked mainframe 

Linked mainframe cannot receive or transmit a spool 
file 

Type of spun off task 
1 = ATTACH 

2 = CATALOG 

3 = POST STAGE (write) 

4 - PRE STAGE (read) 

5 « SPOOLED FILED (in or out) 

6 - DEADSTART OR DUMP FILE 

7 = LOCAL FILE 

File ordinal 

Address for spooling file packet (linkage) 

Number of words to backspace 

Dayfile buffer address 

Address of subchannel table for mainframe 



More 2-word entries following 



DSD/INTERCOM COMMUNICATION THROUGH STATION (MSG TABLE) 

I MSG is used by the CDC CYBER Enhanced Station in a multi-mainframe configuration. This table, 
residing within the station field length, serves as a communication area for DSD, INTERCOM, and 
the station. 
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59 



47 



35 



23 



11 



R 




SCT 




REJCOOE 


MSGBUFF 




PI DC 


ECT 






MSG 












- 







NOTES: 


MSG TABLE 




Field 




Field Name 


Word 






59 




R 


47-36 




SCT 


23-12 




REJCODE 


11-00 




MSGBUFF 


Word 1 






17-12 




P1DC 



11-00 



Word 2 



ECT 



MSG 



Description 

Command or display rejected by linked mainframe 

Station sequence count 

Type of error 

Address reply to the message (relative to RA of 
station). Reply is available when SCT equals ECT 



Identifying character of PID, to which message is 
sent 

External processor (DSD or INTERCOM) sequence 
count. Message should be stored before the word 
containing PIDC and ECT (which should be incre- 
mented by one) 



Message request from external processor to be sent 
to designated mainframe. MSG starts in word 2 and 
can be up to 3 words long 
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SECTION 3 
DISK TABLES AND FILE FORMATS 



PERMANENT FILE DIRECTORY OVERVIEW 



Preamble 



Body 



*7 



Z 



z 



HPj 



PFD 
Allocation Units 



HP(1) 



" One Page 
Contains 32 

,, PFD Entries 



s> 



HP(2) 



Z 



HP(m) 



z 



One Subdirectory 
Contains n Pages 



ID Hash Point 



m = Number of ID Hash Points 

n = Number of Pages between ID Hash Points; must be an Integral Power of two 



m*n 



*n = 



Number of Pages in the PFD Body 
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PFD ENTRY 



59 



47 



W.PDHDR/W.PDSD 

W.PDCPFN 

W.PDEF 

WPDID 



W.PDN1 



WJPDN2 



W.PDN3 



W.PDN4 

W.PDCY 

W.PDIC 

W.PDAC 

W.PDPE 

W.PDPFC 



W.PDPW 



D=l 

1=1 

S=l 



7 7 7 7 



CYCLE NUMBER 



CYCLE NUMBER 



CYCLE NUMBER 



CYCLE NUMBER 



CYCLE NUMBER 



C.POSD 
29 23 17 11 



C.PDCPFN 
S.PDCPFN 
CPDFLAG 
5 



SUB OIR. NO. 



OWNER-ID 



PERMANENT 



— FILE NAME 



LEFT JUSTIFIED. ZERO FILLED 



Mainframe 

ordinal 
(if 1-1 only) 



Mainframe 

ordinal 
(if 1-1 only) 



Mainframe 

ordinal 
(if 1-1 only) 



Mainframe 

ordinal 
(if 1-1 only) 



Mainframe 

ordinal 
(if 1-1 only) 



TURNKEY 



CONTROL 



PASSWORDS 



MODIFY 



EXTEND 



READ 



Chars, 
in PFN 



14B 



PFC POINTER 



PFC POINTER 



PFC POINTER 



PFC POINTER 



PFC POINTER 



Cycle dumped 

Cycle incomplete 

End of subdirectory flag, SPDESD 



F=l Entry in use flag, SPDEF 

ARH=1 Cycle archived 
PE=1 Parity error 



10 



11 



12 



13 



14 



15 
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NOTES: PFD 




Position 




Symbol 


Word 


Within Word 


Contents 


W.PDHDR 





59-48 


7's in binary 






47-36 


PF in variable code 






35-24 


D4 in variable code 



W.PDSD 



W.PDCPFN 



W.PDEF 



W.PDID 



23-12 



11-6 



59-6 



5-0 



Subdirectory number to which the ID 
was hashed (binary) 

Number of characters in the permanent 
file name (binary) 

= entry is free 

1 = entry is in use 

Owner ID, right-justified, blank filled, 

display code 

14B 



W.PDN1 


2 


59-0 


W.PDN2 


3 


59-0 


W.PDN3 


4 


59-0 


W.PDN4 


5 


59-0 


W.PDCY 


6-10 


5948 




6-10 


27 


W.PDFMO 


6-10 


47-36 


W.PDIC 


6-10 


26 



W.PDAC 



W.PDPE 



W.PDPFC 



W.PDPW 



6-10 



6-10 



6-10 



11 



12 



25 



24 



17-0 



59-6 



59-6 



Permanent file name, left-justified, 
trailing binary zeros with no nested 
bytes of zeros 



Cycle number (binary) 

= cycle is not dumped 

1 = cycle is dumped 

Mainframe ordinal (incomplete cycle only) 

= cycle is complete 

1 = cycle is incomplete 

= cycle is not archived 

1 = cycle is archived 

= cycle has no parity errors 

1 = cycle has a parity error 

PFC pointer as a 100B word offset 
(binary) 

Password parameter for TURNKEY 
permission, right-justified, binary zero 
filled, display code 
Password parameter for CONTROL 
permission, right-justified, binary zero 
filled, display code 
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NOTES: PFD (CONT'D) 



Symbol 

W.PDPW 
(continued) 



Word 

13 

14 
15 



Position 
Within Word 

59-6 



59-6 



59-6 



Contents 

Password parameter for MODIFY 
permission, right-justifed, binary zero 
filled, display code. 

Password parameter for EXTEND 

permission, right-justified, binary zero 

filled, display code 

Password parameter for READ permission, 

right-justified, binary zero filled, display 

code 
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PERMANENT FILE CATALOG OVERVIEW* 



Preamble 



Body 



4* 



PFC 
Allocation Units 



PFC Block 



PFC Block 



1 Page = 512 Words 



1 Page = 8 Blocks = 512 Words 



<h 



Each PFC entry occupies one or more consecutive PFC blocks. 



tpFC was formerly called the RBTC (Record Block Table Catalog). 
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PERMANENT FILE CATALOG (PFC) ENTRY FOR PERMANENT FILES 



59 



W.PCFC i W.PCEF 
W.PCARC i 
W.PCFO 
W.PCRA 
W.PCPS 

w:p^ T o B ) Wf,CSD 

W.PCN1 



W.PCN2 



W.PCN3 



W.PCN4 



W.PCCY 

W.PCPDE 

W.PCPFD 



W.PCCD 
W.PCRT 

W.PCOLA 
W.PCTLA 

W.FCDLME 
W.PCTLME 



W.PCNA 
W.PCNE 
W.PCNM 
W.PCESZ 



w.pcs ) 

W.PCT > 
W.PCSD) 



W.PCACT 



W.PCOLO 
W.PCTLO 



W.PCPW 



I 



S3 



41 



35 



23 



11 8 6 4 2 



7777 



9 ' 



Owner 10 (Right Justified. Blank Filled) 



-"S 



1 4 



Penranent File Name 
(Left Justified. Zero Filled) 



Cycle 



Binary Creation 
Date (YYDDD) 



Binary Date of Last 
Attach (YYDDD) 



Binary Data of Last 
Alteration (YYDDD) 



Number of 
Attaches 



PFD 
Entry 
Offset 



PFD Pointer 
(in PRU Offset) 



Retention Period 
(Binary) 



Number of 
Extends 



Pointer to S 



Number of 
Modifies 



Pointer to T 



Binary Time of Last 
Attach (HHMMSS) 



Binary Time of Last 
Alteration (HHMMSS) 



Size of 
Entry 



Subdirectory 
Number 



Account Parameter 



Dump Tape VSN 1 



Dump Tape VSN 2 



SETP Pointer 



CKP Pointer 



(Reserved) 



Binary Date of Last 
Dump (YYDDD) 



Binary Time of Last 
Dump (HHMMSS) 



Turnkey Password 



Control Password 



Modify Password > (Right Justified. Binary Zero Filled) 



Extend Password 



Read Password 



Pf*C Interlock 



PFC Interlock 
MMF-2 



PFC Interlock 



Installation Slot 



RBT Chain 



(Reserved) 




PFC Interlock 





1 

2 

3 

4 

5 

6 

7 

10 

11 

12 

13 

14 

15 

16 

17 



EF=1 


Entry free 


RAN=1 


Random 


NV=1 


New version 


F0=1 


File organization IS/DA/ AK 


9T=1 


Nine-track 


ARC=1 


Archived 


P0S=1 


Positioned 


RB=1 


RB conflicts 
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Detail: PFC I/L Byte 



1 1 

10 9 8 7 



5 4 3 2 10 



1 S.PFCSW single write 

I — S.PFCSM single modify 
S.PFCEA exclusive access 



-S.PFCORB obsolete RBT chain in CM 
S.PFCAT attached 
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PFC ENTRY FOR I/O QUEUES 



59. 



47 



35 



23 



11 9 4 10 



7777 



7777 



T C 



Copy of FNT 



Copy of Supplementary FNT 



Binary Creation 
Date (yyddd) 



10 



12 



13 



Pointer to S 



Pointer to T 



Size of 
Entry 



^15-23 



Copy of Additional 
Supplementary FNT 



(Reserved) 



PFC Interlock 
MMF-1 



PFC Interlock 
MMF-2 



PFC Interlock 

MMF-3 



24 



25 



26 



PFC Interlock 
MMF-4 



Installation Slot 



I 



RBT Chain 



(Reserved) 



77 
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PFC ENTRY OVERFLOW 



4 1 



RBT Chain 



(Reserved) 



End of 
Chain or 
76 

77 



Q=0 Permanent File PFC entry Q=1 Queue PFC entry 

DEVICE SET RBT CHAINS IN PFC 
FIRST RBT WORD PAIR 



59 


47 


38 


35 


29 


23 


11 


C.RBTWPL 




7 


C.RBTAL 
Device 
Type 


Alloc. 
Type 


C.RBTPRU 

Last PRU + 1 


C.RBTBIT 

Flags 


C.RBTDRB 

DAM Ordinal 


C.RBTVSN 


Volume Serial Number 


RB 7 



OTHER WORD PAIRS EXCEPT OVERFLOW 



59 



47 



38 35 



23 



11 



C.RBTWPL 







RB 


RB., 


RB 2 


RB 3 


RB 4 


RB 5 


RB 6 


RB 7 



OVERFLOW WORD PAIRS 



59 



47 



38 35 



23 



11 



C.RBTWPL 


777 


7 




End of Volume 
PRU+ 1 




C.RBTDRB 

DAM Ordinal 


C.RBTVSN 

Volume Serial Number 


0000 
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FIRST RBT WORD PAIR: TYPE (PRE-SCOPE 3.4.4 CREATED PUBLIC DEVICE FILES) 



59 



47 S.RBTRBR 35 



29 



23 



11 



C.RBTWPL 
Next Word Pair 


C.RBTRBR 

C.RBTFB 

RBR Ordinal 


3 


C.RBTAL 
• Alloc. 
I Type 


C.RBTPRU 
Last PRU+1 


C.RBTBIT 
Flags 


RB3 


RB4 


RB5 


RB6 


RB7 



SUBSEQUENT WORD PAIRS: 



59 



47 



35 



23 



11 



C.RBTWPL 
Next Word Pair 


C.RBTRBR 

C.RBTFB 

RBR Ordinal 





RBO 


RB1 


RB2 


RB3 


RB4 


RB5 


RB6 


RB7 



For queue files the end of the input file RBT chain is flagged with 7777B in the next word pointer field 
(C.RBTWPL) if a predayfile follows. In all cases a zero in C.RBTWPL indicates end of chain. 
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NOTES: PFC 
Symbol 
W.PCEF 



Word 





Meaning 

Bit 1 


1 = free 




= locked 



W.PCFC 

W.PCARC 

W.PCPO 

W.PCRA 

W.PCPS 

W.PC9T 

W.PCRB 

WJCHDR 

W.PCID 

W.PCN1 - 
W.PCN4 

W.PCCY 

W.PCPDE 

W.PCPFD 

W.PCCD 

W.PCRT 

W.PCDLA 

W.PCTLA 

W.PCDLME 



2 
3-6 

7 

7 

7 

10 

10 

11 

11 

12 



Bit 4 = permanent file entry 

1 = queue file entry 

Bit 2 1 - new 

s dumped 

Bit 4 = cycle is not archived 

1 = cycle is archived 

Bit 5 = file is not a SAAM file 

1 = file is a SAAM file 

Bit 6 = file is not random 

1 = file is random 

Bit 7 » file is not positioned 

1 - file is positioned 

Bit 8 = 7-track tape 

1 = 9-track tape 

Bit 9 - no RB conflicts 

1 = RB conflicts exist on this file 

RBTC in display code 

14 octal in bits 5-0. Owner ID in bits 59-6 

Permanent file name in display code, left justified, zero filled 

Cycle number in binary 

PFD entry number 

PFD pointer as a sector offset (binary) 

Bits 59-42 contain the creation date in binary in the format YYDDD 

Bits 23-12 contain the retention period in binary 

Bits 59-42 contain the date of the last attach in binary in the format 
YYDDD 

Bits 17-0 contain the time of the last attach in binary in the format 
HHMMSS 

Bits 59-42 contain the date of the last alter in binary in the format 
YYDDD 
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NOTES: PFC (CONT'D) 

Symbol Word 

W.PCTLME 12 



W.PCNA 


13 


W.PCNE 


13 


W.PCNM 


13 


W.PCESZ 


13 


W.PCS 


14 


W.PCT 


14 


W.PCSD 


14 


W.PCACT 


15 




27 



Meaning 

Bits 17-0 contain the time of the last alter in binary in the 
format HHMMSS 

Bits 5948 contain the number of attaches in binary 

Bits 47-36 contain the number of extends in binary 

Bits 35-24 contain the number of modifies in binary 

Bits 23-12 contain the size on the entry in binary number 
of words 

Number of words from word 13 to the user area 

Number of words between word 13 and start of RBT chain 

Bits 23-12 contain the subdirectory number in binary 

Account parameter in display code, left-justified, blank fill 

PFC interlock for MMF configuration; each byte contains the 
following flags: 

bit 1 single write (S.PFCSW) 

bit 2 single modify (S.PFCSM) 

bit 3 exclusive access (S.PFCEA) 

bit 8 obsolete chain in CM (S.PFCORB) 

bit 10 file attached (S.PFCAT) 
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PERMANENT FILE SET DEVICE LABEL 



59 



53 



35 



29 



23 



17 



11 



W.LBLD ) 
W.LBTYPE > 
W.LBDATE I 


DEV1 


02 


YYDDD 





/ 
W.LBEX 




YYDDD 


1 


W.LBVSN 


VSN 




2 


W.LBSN \ 
W.LBMEM / 


Sat Name 


* Maximum Number''' 
of Members 


3 


W.LBPFD 




PFD Alloc. 
Unit Index 


4 




Reserved for CDC 


5 


W.LBPFC 




PFC Alloc. 
Unit Index 


6 




Reserved for CDC 


7 


W.LBDAM 




* DAM Alloc 
Unit Index 


8 


W.LBSMT 




* SMT Alloc. 
Unit Index 


9 


W.LBFLW 




Number of | 
Extra Flaw Tables 


* Flaw Table 
Alloc. Unit index 


10 


W.LBSFT 


Reserved for CDC 


11 


W.LBDSR 


(Reserved for Deadstart Recovery) 


* Deadstart Recovery 
RB Number 


12 


W.LBSD 




* Subdirectory Table 
Alloc. Unit Index 


13 


W.LBPCM 


U 




* PFC Alloc. Map 
Alloc. Unit Index 


14 


W.LBFLT 




* Physical Flaw Table 
Alloc. Unit Index 


15 


W.LBNPFG ) 
W.LBNPFP } 
W.PBNSD 1 




* Number of PFC 
Words/100B 


* Number of PFD 
Pages per Subdirectory 


* Number of 
Subdirectories 


16 


W.LBCK 




Checksum 


17 



* Field will contain non-zero value only on master device 
tThe length of the SMT is twice the value contained in this field 
U-Bit 59 indicates subdirectory counts are invalid 
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PERMANENT FILE SET DEVICE LABEL (CONT'D) 



W.L8AUS 



W.LBDUP 



W.LBDPI 



W.LBDFR 



W.LBOIAG 



W.UBIL 



W.LBLI1 



W.LBLI2 



W.LBLI3 



W.LBLI4 



W.LBDSM 



W.LBGLA 



W.LBCHS 



59 


47 




35 


23 




11 







Alloc, unit 

size in 
words/ 1 00 B 


UNIVERSAL PERMISSION PASSWORD (RESERVED) 




PUBLIC PERMISSION PASSWORD (RESERVED) 






tDefault file 

retention 

period (Reserved) 


CE AREA PR EAL LOCATION ,. ° * P , rea " oca * ed 

All 7's= Not Preallocated 


C.LBNMF 
number of 
MNTed MFs 


C.LBSETI 
MF 1 


MF2 


MF3 


MF4 


C.LBEO 
EST ord 


C.LBMO 
MF ord 


C.LBATT 
local 
attr. 


No. of 
DUMPFs 


C.LBLID 

host MF PIO 

MF 1 








































C.LBDSM 

DSMNT 

flag 










C.LBGLA 
Global 
Attri. 


date 1st DUMPF 


time 1st DUMPF 


dump mode 





18 



19 



20 



21 



22 



23 set l/L 



24 



25 



26 



27 



28 



29 



log-in 

table 



30 DUMPF 
synchr. 



Field contains non-zero value only on master device. 
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Detail: Set l/L Byte in W.LBIL 



1 1 

10 9 8 7 6 5 4 3 2 10 



I — SET l/L (S. 



LBSETI) 



Detail: Local attributes in W.LBLI1 through W.LBLI4 



Global Attributes in W.LBGLA 



2 2 2 2 2 2 
9 8 7 6 5 4 



I — SYSTEM SET (S.LBLASS) 
- PF DEFAULT SET (S.LBLFPF) 
_ QUEUE SET (S.LBLAQS) 
SYSTEM DEFAULT SET (S.LBLASD) 

SYSTEM DEVICE (S.LBLASY) 

SHARED DRIVE (S.LBLASH) 



11 



l_ Q DEVICE (S.LBAQ) 
PF DEVICE (S.LBAPF) 
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NOTES: PERMANENT FILE SET DEVICE LABEL 



Symbol 


Words 


Position 
Within Word 


Contents 


W.LBLD 





59-36 


DEVI in display code 


W.LBTYPE 





35-30 


02 = 6000/7000 


W.LBDATE 





29-0 


The date in the form YYDDD (display 
code) 



W.LBEX 



W.LBVSN 



W.LBSN 



29-0 



59-24 



59-18 



W.LBMEM 


3 


17-0 


W.LBPFD 


4 


17-0 




5 


59-0 


W.LBPFC 


6 


17-0 




7 


59-0 


W.LBDAM 


8 


17-0 


W.LBSMT 


9 


17-0 


W.LBFLW 


10 


17-0 




11 


59-0 


W.LBDSR 


12 


17-0 


W.LBSD 


13 


59 


W.LBPCM 


14 


17-0 



W.LBFLT 



15 



17-0 



The expiration date in the form YYDDD 
(display code) 

VSN (display code) right-justified, display 
zero filled 

Setname (display code) left justified, 
binary zero filled 

Maximum number of members (binary) 

PFD allocation unit index (binary) 

CDC reserved 

PFC allocation unit index (binary) 

CDC reserved 

DAM allocation unit index (binary) 

Set member table allocation unit index 
(binary) 

Flaw table allocation unit index (binary) 

CDC reserved 

Deadstart recovery RB number 

1 = pack created under SCOPE 3.4.x 



PFC allocation map allocation, unit 
(binary) 

Physical Flaw Table allocation unit index 
(binary) 
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NOTES: PERMANENT FILE SET DEVICE LABEL (CONT'D) 







Position 


Symbol 


Words 


Within Word 


W.LBNPFC 


16 


53-36 


W.LBNPFP 


16 


35-18 


W.LBNSD 


16 


17-0 


W.LBCK 


17 


11-0 



Contents 

Number of PFC words/lOOB 

Number of PFD pages per subdirectory 
(binary) 

Number of subdirectories (binary) 

Checksum of this label PRU 
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SET MEMBER TABLE (MASS STORAGE) 



W.SMTVSN 
W.SMTFRB 
W.SMTLRB 

W.SMTUS 
W.SMTSA 
W.SMTSFF 
W.SMTSM 

W.SMTVSN 
W.SMTFRB 
W.SMTLRB 

W.SMTUS 
W.SMTSA 
W.SMTSFF 
W.SMTSM 



59 



BC 



Hm^ 



48 



41 



23 



17 



11 



VSN 



OF 



EE 



EE 



Space Available 



VSN 



Space Available 



First 
DAM Pointer 



Last 
DAM Pointer 



Usable Space 



First 
DAM Pointer 



Last 
DAM Pointer 



Usable Space 



For 844 device First DAM pointer = Last DAM pointer. 



A » PF Device (S.SMTSFF) 

SM = Mounted Flag (S.STMTSM) 

B = Recover Flag 

C = Queue Device (S.SMTSFQ) 

D = Preallocated for C. E. diagnostics (S.SMTPR) 

E = Mounted on MF ordinal 1-4 (bit 51 - 1, 50 = 2, 49 = 3, 48 = 4) (S.SMTMF) 

F = Operator Requested Dismount (S.SMTOD) 

The length of the SMT is two times the maximum number of members as shown in word 3 of the master 
device label. 

Zero entries can be intermixed with VSN entries for member devices. 
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NOTES: SET MEMBER TABLE 



Symbol Words 

W.SMTVSN Even 

W.SMTFRB Even 

W.SMTLRB Even 



W.SMTSFF 



W.SMTSM 



W.SMTSA 



W.SMTUS 



Odd 



Odd 
Odd 



Odd 



Odd 



Position 
Within Word 

59-24 



2342 



11-0 



59 



58 

57 
56 

53 
52 
51-48 



41-24 



17-0 



Contents 

VSN of the pack, right justified, display 
zero filled 

First DAM pointer as a sector offset 
(binary) 

Last DAM pointer as a sector offset 
(binary) 

= permanent files do not reside on 

this device 

1 = permanent files may reside on this 

device 

SM = Device is not mounted 
SM = 1 Device is mounted 
RECOVER Interlock (master pack only) 

= Queue files do not reside on this 

device 

1 = Queue files may reside on this device 

= Device is not preallocated 

1 = Device is preallocated 

- Operator dismount not outstanding 

1 = Operator dismount outstanding 

= Not mounted by mainframe with this 

mainframe ordinal 

1 = Mounted by mainframe with this 

mainframe ordinal 

Total alloeatable space available on this 
device (binary)-number of allocation 
units currently not in use on the device 

Total number of allocation units minus 
number of flaws and minus number of 
system table allocation units 



A two word entry will exist for each member in this set. 
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OVERVIEW OF DEVICE ALLOCATION MAP 



63 



Allocation Units 



DAM Entries 



64 Words 



Every DAM starts on a sector boundary. If the entry needs to be greater than 64 words, it will always be 
overflowed to the next PRU or PRUs. 

An 844 DAM may contain a maximum of 50jo entries; i.e., the entire DAM requires one allocation unit. 
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DAM HEADER 



W.DADAU 

W.DADCA 

W.DADSZ 

W.DADVSN 

W.DADSMO 

W.DADSAU 

W.DADAS 

W.DAOUA 

W.DADSDA 

W.DADSA2 

W.DADPBC 



59 



53 



35 



29 



23 



11 





Total Number of 
Alloc. Units 




Available 
Alloc. Units 


Size of 
Bit Table 


VSN 


SMT Ordinal 


Sector/Alloc. 
Unit 


A 




SDA 
Extend 


Alloc. 
Style 


Usable 
Alloc. Units 


Starting 
Dev. Address 



'Values exceeding 4095D are not supported. 
A-RB size/PB size compatibility bit 



NOTES: DAM 








Symbol 


Words 


Position 
Within Word 


Contents 


W.DADAU 





53-36 


Total number of allocatable units 


W.DADCA 





29-12 


Currently available allocatable units 


W.DADSZ 





11-0 


Size of bit table in words 


W.DADVSN 


1 


59-24 


VSN 


W.DADSMO 


1 


23-12 


Set member ordinal 


W.DADSAU 


1 


11-0 


Sectors per allocatable unit 


W.DADSA2 


2 


41-36 


Extension of starting device address 
(W.DADSDA) 


W.DADPBC 


2 


59 


If set, device was created on a system with 
PB size of 11 2D for 844s 


W.DADAS 


2 


35-30 


Allocation style 


W.DADUA 


2 


29-12 


Usable allocatable units = total allocatable 
units - flaws - system allocatable units 


W.DADSDA 


2 


11-0 


Starting Dev. address 


W.DADRCA 


S3 


7-0 


Preventive Maintenance (844 s) 1 


W.DADRCB 


54 


59-0 


1 
Reserved cylinders 
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LOGICAL FLAW TABLE 

The Logical Flaw Table has the same format as the DAM, but only bits corresponding to flawed sectors 
(within allocation unit) are set. 

PHYSICAL FLAW TABLE 

PHYSICAL FLAW TABLE FORMAT: 7638/844 



W.PHFNF 

W.PHFAR 
W.PHFAL 



59 


29 




11 







Number 
of Flaws 


Flaw Address 


Flaw Address 


Flaw Address 


Flaw Address 


•'.■.-.•. 


Flaw Address 


Flaw Address 



777 8 



PHYSICAL FLAW TABLE FORMAT: 6603/6633/821/841/854 



11 



Note: The Physical Flaw 
Table may contain a maximum 
of lOOOg words. 



Note: Each device contains 
its own Logical Flaw Table 
and Physical Flaw Table. 



End of List 



777c 



Each F(jj is a 24-bit physical address corresponding to a particular flaw. 
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PHYSICAL FLAW TABLE ENTRIES 



7638 Address 



844 Address 



59 






41 


35 


29 






11 


5 


Track Number 


Initial 
Sector 


No. of 
Sectors 


Track Number 


Initial 
Sector 


No. of 
Sectors 


59 56 47 41 35 30 26 17 11 5 




Cylinder 
Number 


Track 
Number 


Initial 
Sector 


No. of 
Sectors 




Cylinder 
Number 


Track 
Number 


Initial 
Sector 


No. of 
Sectors 



6638 Address 



11 


10 




7 


5 





Position 


Head Group 





Sector 



11 



9 8 



6603 Address 



2 1 






H3 


Position 


H2 


H1 





Sector 
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PHYSICAL FLAW TABLE ENTRIES (CONT'D) 



Sector 






Lower 5 Bits of Sector 



11 9 



821 Address 



Cylinder 



Head Group 



Sector 



* Bit = Stack Bit 



841 Address 



11 




7 


5 





Cylinder 


Track 


Sector 



854 Address 



11 




7 


* 


* 





Cylinder 





Track 


Sector 
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SUBDIRECTORY TABLE 



Interlock 


Interlock 


Interlock 


Interlock 


Interlock 


Bit 


Bit 


Bit 


Bit 


Bit 



59 



47 



Word 



35 



23 



11 





# of Entries 

Hashed to This 

SD Ordinal 




# of Entries 

Hashed to This 

SD Ordinal 




# of Entries 

Hashed to This 

SD Ordinal 




# of Entries 

Hashed to This 

SD Ordinal 




# of Entries 

Hashed to This 

SD Ordinal 













































Subdirectory Description 



Symbol 





Position 


Words 


Within Word 


0-n 


59,47,35, 23, 11 


0-n 


5848, 46-36, 34-24, 




22-12, 10-0 



Contents 

Interlock bit; always zero on RMS copy 
of the table. Reserved for 7000 use only 

Number of entries that have hashed to 
this subdirectory ordinal (binary) 
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PFC ALLOCATION MATRIX (PAM) 

(Reserved for SCOPE 2 processing) 



59 



47 



41 



W.PAMNW 

W.PAMPEI 
W.PAMCEI 



23 



17 





Number of Words in 
PAM Body = n-1 




Purge EOI Pointer 




Current EOI Pointer 


7777 
7777 

7777 


PAM Body: One Interlock Bit per 
PFC Entry. I/L Bit=1 
Indicates Entry Is in Use. 



NOTES: PAM 




Position 


Symbol 


Words 


Within Word 


W.PAMNW 





17-0 


W.PAMPEI 


1 


41-24 


W.PAMCEI 


1 


17-0 



Contents 

Number of words in PAM body 

Pointer to empty 100B word block 
created by purge as a PFC sector offset 

PFC sector offset to first 100B word 
block not in use after the last 100B 
word block in use 



The PAM body represents one interlock bit per PFC entry. A PAM bit set implies that an entry is in use. 
Only bits 47-0 of the body are used. 
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W RECORD HEADER 
59 53 



41 



23 



17 



t 



(Reserved) 



Word Count of 
Previous Record 



Unused 

Bit 
Count 



Word Count of 
Current Record 



(Reserved for Installation 
Delete Bit 
•—Flag Bit 
•-Parity Bit 



I BLOCK HEADER 



59 


53 


41 




17 





I 


Block 

Ordinal 

(Mod 2 ,2 > 


Record Number 


Word Offset 


L( 

L-(Re« 

•-Check 

—Parity b 


Reserved for Installati 

.erved) 

sum bit 

it 


on) 









BLOCK FORMAT (DA FILE) 
59 52 



34 



29 



PRU Pointer to Previous 
Block in Chain 



Delete J 
Bit -S 



Unused 
Char 
Count 



PRU Pointer to Next 
Block in Chain 



(Reserved for Installation - BLK HDL Words) 



Record Length 
in Words 



PRU Pointer to Preceding Block If 
This is an Overflow Block 



Record 



Optional Checksum 
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INDEX BLOCK FORMAT (IS FILE) 





59 






29 


23 


17 




INDEX 


Index 
Level Number 


First Word 
of Padding 






Low Key 








Flags 


PRU Pointer to Lower Index 
Level or to Data Block 




=» -aC 






High Key 










Flags 


PRU Pointer to Lower Index 
Level or to Data Slock 


■<Z. 


P» 




Padding *s£ 








Optional Checksum 



DATA BLOCK FORMAT (IS FILE) 



59 



36 29 23 17 



PRU Pointer to 
Next Sequential Data Block 



Current Size of Padding 



High Key 



Lev Key 



Unused 

Bit 
Count 



High Record 



Padding 



Optional Checksum 



First Word of Padding 



=*■ (Reserved for Installation) 




-^ 




Unused 

Bit 
Count 




Record Size 


Low Record 


. 









Record Size 



FWA of Record Header 



FWA of Record Header 



DAHDRS2W 
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FSTT (INDEXED SEQUENTIAL FILE) 



CHEKSUM 
HEADWORD 
M IP WORD 

AVALDABK 

AVALINBK 

CHKSUMB 
CODITABL 
CODITA62 
COOITAB3 
CODITAB4 
CODITAB5 
CODITAB6 
CODITAB7 
CODITAB8 

CURF1LPP 

DABKSZP 

DABKSZW 

DAPADSZW 

DELETSTO 

DICOTABL 

DICOTAB2 

DICOTAB3 

D1COTAB4 

DICOTAB6 

DICOTAB6 

DICOTAB7 

OICOTAB8 

DUPKEYB 

FEMDABK 

FEMINBK 

FILDATE 

FILNAME 

FIRDABK 

INBKSZP 

INBKSZW 



59 


44 


35 


23 


17 


FSTT Checksum 


SAAM-SISV2 


(Reserved for MIP) 




PRU Number of Next 
Empty Data Block 




PRU Number of Next 
Empty Index Block 










Collating Sequence 
to Display Code 
Conversion Table 










. 
























PTREE Index 


Key Displacement in 
Data Block 


Address of 
Buffer Catalog 




Data Block Size in PRUs 




Data Block Size in Words 




Data Block Padding Size in Words 


Total DEUETEs 


— _— 






Display Code to 






















Conversion Table " — "~ ~~ 







■— — 




— *— M- 






-« * Duplicate Keys Allowed 




Deleted Data Block Chain Pointer 




Deleted Index Block Chain Pointer 


File Creation Date 


Logical File Name 




First Data Block Pointer 




Index Block Size in PRUs 




Index Block Size in Words 





1 

2 
3 



5 
6 
7 
10 

11 

12 
13 
14 
15 

16 

17 

20 

21 
22 

23 
24 
25 
26 
27 
30 
31 
32 
33 
34 
35 
36 
37 
40 
41 
42 
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FSTT (INDEXED SEQUENTIAL FILE) (CONT'D) 





59 


29 


23 


11 


3 2 


INPADSZW 




Index Block Padding Size in Words 


KEYBIAS 




COMP-1 
Floating Bias 


KEYENSZW 




Key Entry 
Size (words) 


KEYPACKB 










KEYSZC 




Key Size in 
Characters 


KEYTYPE 


Key Type — W 


LASDABK 




Final Data Block Pointer 


MAXRECSZ 




Maximum Record Size in Chars 


MINRECSZ 




Minimum Record Size in Chars 


NRACSTO 


Total GETs 


NROABKTO 




Total Number of Data Blocks 


NRDAREC 


Total Number of Data Records 


NREMDABK 




Number of Deleted Data Blocks 


NREMINBK 




Number of Deleted Index Blocks 


NRINBKTO 




Total Number of Index Blocks 


NRINSTO 


Total PUTs 


NRLVLSF 




Number Index 
Block Level 


NRWUDISK 


Number of Unused Words on Disk 


NXTUNASP 




Next Unassigned PRU Number 


PRINBK 




Primary Index Block PRU Number 


REPLACTO 


Total REPLACES 


SEQINSS 


- Limit of Sequential INSERTs 


Number of Sequential INSERTs 


TERMOATE 


Date of Last CLOSEM 


TERMTIME 


Time of Last CLOSEM 


UEPRINBK 


Number of Unused Key Entries in Primary Index Block 



43 

44 

45 
46 

47 

50 

51 
52 
53 

54 
55 
56 
57 
60 
61 
62 

63 

64 
65 
66 
67 
70 
71 
72 
73 
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FSTT (DIRECT ACCESS FILE) 

59 53 



CKSWORD 
HEADER 

MIPWORD 

CSFLAG 

STATADO 

STATDLT 

STATRPL 

STATRET 

STATOVF 

STATHOM 

STATHR 

STATOR 

FILESZ 

KEYS 

MINMAXS 

NXTUNASP 

NXTUPDSK 

DATABKSZ 

PRUBLK 

OVFOP 



ENDFIXD 



RUNADD 

RUNDLT 

RUNRET 

RUNRPL 

RUNOVF 

RUNHOM 

RECHOM 

RECOVF 

NRCIOCLS 

CURPRtJ 

RELDBW 

BUFCATS 



35 



29 



23 20 17 



FSTT Checksum 



(Reserved for SIP) 



-Block Checksum Option (BCK at OPENM NEW} 



Total Number of PUTs 



Total Number of DELETES 



Total Number of REPLACES 



Total Number of GETsand GETNs 



Total Number of Overflow Blocks 



Relative Key Position (RKP) 



Number of Home Blocks in Use 



Total Number of Records in Home Blocks 



Total Number of Records in Overflow Blocks 



Total Number of Home Blocks 



Relative Key Word (RKW) 



Minimum Record Size (MNR) 



Key Length (KL) 



Maximum Record Size (MRL) 



Next Unassigned PRU Number 



Next Usable PRU on disk 



Data Block Size (words) 



Number of PRUs per Block 



Overflow Manager 



Number of PUTs - Current OPENM 



Number of DELETES - Current OPENM 



Number of GETs and GETNs - Current OPENM 



Number of REPLACES -Current OPENM 



Number of Overflow Blocks Created - Current OPENM 



Number of Home Blocks in Use First Time - 
Current OPENM 



Number of Records in Home Blocks - Current OPENM 



Number of Records Placed in Overflow Blocks - 
Current OPENM 



Total Number of CIO Calls 



Current PRU for Use by GETN 



Relative Data Block Word 
for Use bv GETN 



Address of Buffer Catalog 





1 

2 

3 

4 

5 

6 

7 

10 

11 

12 

13 

14 

15 

16 

17 

20 

21 

22 

23 

24 

25 

26 

27 

30 

31 

32 

33 

34 

35 

36 

37 



— Length of Buffer Catalog 
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FSTT (DIRECT ACCESS FILE) (CONT'D) 



59 



29 



23. 



17 



LASBZBUF 

LASTSK 

BITMAPS 

WORDCT 

STRNGSP 

EMPTYSP 

AVAILSPC 

STRANGER 
ADDRPL 

RECLNGTH 

KEYBUFF 

EOFBIT 
FWBVALUE 
LSTOP 
BCUPOT 

FSTTPOS — ' 



Most 
Empty 
Table 



Address of Last Accessed 
Data Block 



PRU Number of Last SEEK 



Address of Bit Map 
(Creation Run Only) 



Record Header of Record to be PUT 



Stranger Space in 
Receiving Block 



Empty Space in 
Receiving Block 



Empty Space in Block 
of Record to be Removed 



Stranger Space in Block 
of Record to be Removed 



File Position Undefined for GETN 



Unused 
Bits 



Record Length 



Address of Key 
Alignment Buffer 



Address of User Buffer 



Last Operation Code 



BUFCAT Address of Last Update 



(Reserved) 
(Reserved) 



PRU Address of a Data Block 



Empty Space in the Block 



40 

41 
42 
43 

44 
45 

46 

47 
50 

51 

52 

53 
54 
55 
56 



66 
67 
70 



^ 



11 



| II-3-32 



60306500 H 



FSTT (ACTUAL KEY FILES) 



59 



35 



23 



17 



CKSWORD 

HEADER 

MIPWORD 

CSFUAG 

KEYL 

SLOTL 

NXTBLK 

END8LK 

MINMAX$ 
NXTUPDSK 

PRUBLK 
KEYM 

SLOTM 
NOR EC 

OVFREC 

BLKFCTR 

DBLKPD 

CURBCK 

RANDOM 

EMTABLE 



FSTT Checksum Word 



M 



MIPWORD to be Used by SIP 



Bit Set in Data Block to be Checksummed 



Key Length in Bits 



Length of Slot — Number Field in Bits 



Next Unassigned Block Number 



Relative Pointer to First Header 



Maximum Record Size 



Minimum Record Size 



Next Used PRU No. on Disk 



No. of PRU's Per Block 



Key Mask (Right Justified) 



Slot-Number Field Mask 



Number of Records in the File 



Number of Overflow Records in File 



Blocking Factor 



Data Block Padding (In Words) 



Current Block Number (SAKOVFM) 



Current Random Number (Used by SAKOVFM) 



Empty Space Table 





1 

2 

3 

4 

5 

6 

7 

10 
11 

12 
13 

14 
15 

16 
17 
20 
21 
22 
23 
24 
25 
26 
27 
30 
31 
32 
33 

34 
35 
36 
37 
40 
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FSTT (ACTUAL KEY FILES) (CONT'D) 



METABLE 



ENDFIXD 

RUNADD 

RUNDLT 

RUNRET 

RUNRPL 

BUFCAT$ 

RECLNGTH 

FWBVALUE 

CURPOS 

HDADD1 

6UFCAT1 

HDADD2 

BUFCAT2 

FSTHDR 

LSTHDR 

RECHD 

RECADD 

BKPTR 

EXTEND B 

EOIBIT 

EOFMARK 



59 


35 


17 




npty Table 
for End of Permanent Data 












Most Er 
























Symbol 




Number of Puts This Open 


Number of Deletes This Open 


Number of Accesses This Open 


Number of Replaces This Open 




Length of BUFCAT 


Address of BUFCAT 


Record Length in SAK Format 




FWB (FIT) 


Current File Position 




Pointer to Record Header 




BUFCAT Address (HDADD1 




Pointer to Overflow Header 




BUFCAT Address (HDADD2 




Pointer to First Header in List 




Pointer to Last 
Header in List -1 


Current Record Header 




Add. of Current Record 




Back Pointer For 
Current Record 






"* 






~2 










j 













41 
42 
43 
44 
45 
46 
47 
50 
51 
52 
53 
54 
55 
56 
57 

60 
61 

62 

63 

64 
65 
66 
67 

70 

71 
72 

73 

74 
75 
76 
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SWAP FILE FORMAT 



Positive _ 
Field Length 



Control 
Word 



Job Field Length 



, Control Point Area 



Dayfile FNT 



Dayfile FET 



Dayfile Buffer 



Checksum of Positive FL FNTs 



No. of PP Delay 
Stack Entries 



FL/100B 
After Swapin 



No. of FNTs 



PP Delay Stack Entries 
(5 words/entry) 



FNT Entries 
(LE.FNT words/entry) 



Jobname 



Checksum of Positive Field Length 



RA 



FL Words 



RA+ FL 
200 8 Words 

LE.FNTO) Words 
1 Word 

LE.DFB Words 

1 Word 



*A Words 

*B Words 

1 Word 
1 Word 
1 Word 



2 Words 
Minimum 
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SECTION 4 
EXTENDED CORE STORAGE TABLES 



OVERALL ECS FORMAT 

ECS FORMAT 



ECS Label Area 



Partition 1 
(Type COMMON If IP.ECSLK=£0) 



Partition 2 



Partition 3 



t 



Partition n 



~T~ 

1000B 



J 



ECS label is written to one of the areas starting at 120B, 230B, 340B, 450B, 560B, or 670B. 



ECS LABEL 

59 53 



35 29 23 



11 



E C S 1 







CMR ID That Wrote Label 



Checksum 



Number of 
Partitions 



ECS 
Length/ 1000B 



Partition 1 Name (LINK if IP.ECSLK#0 



1 
2 



Type 



Flag Bits 



FWA/1000B 



FL/1000B 



Partition 2 Name 



Type 



Flag Bits 



FWA/1000B 



FL/1000B 



Partition 3 Name 



Type 



Flag Bits 



FWA/1000B 



FL/1000B 



Partition n Name 



Type 



Flag Bits 



FWA/1000B 



FL/1000B 



10 



11 



Maximum number of partitions = 9 



Type = IB Direct access area 

2B Allocatable device area (system and paged area) 
3B COMMON 
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DIRECT ACCESS AREA (TYPE 1 PARTITION) 



Direct 

Access 

Area 



Direct Access 
Area Available to User 



ALLOCATABLE DEVICE AREA (TYPE 2 PARTITION) 



System 
Area 



Paged 
Area 



Inter-Computer Area (ICC) 



System Pointer Area 



Flaw Table 



Empty Page Stack 
(Length Computed at Deadstart; 1 Word/Page in Paged Area) 



System Pages and Data Pages 



IP.EICC 



IP.ESYS 



IP.EFLW+1 



H-4-2 
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COMMON AREA (TYPE 3 PARTITION) 

E9 42 



28 



15 



4 3 



Link Buffer 
Reservation 
Table 



Buffers 



Reserved 



HID1 



HID2 



Reserved 



Reserved 



L 
N 
HID1 

HID2 

BUF1 

BUF2 

Bl 
B2 



60306500 L 



BUF1 



BUF2 



B1 



B2 



First 
Entry 



Additional 
■ Entries 



Length of each buffer 

IP.LNKBF; number of entries in table 

Mainframe ID of first mainframe to reserve 

a buffer for this link 

Mainframe ID of second mainframe to reserve 

a buffer for this link 

FWA of receiving buffer for first mainframe 

(HID1) and send buffer for second mainframe 

(HID2) 

FWA of receiving buffer for second mainframe 

(HID2) and send buffer for first mainframe 

(HID1) 

TN.BUF1 ; link status bit in the ECS interlock 

register for BUF1 

TN.BUF2; link status bit in the ECS interlock 

register for BUF2 



II-4-2.1/II-4-2.2 



INTER-COMPUTER AREA 



47 



23 



14 
15 



Length of System Area 



Size of ECS/1000B 



(Reserved) 



(Reserved) 



Length of ICC Area 



Library Size/10008 



| Address 1st active system page* 



ICC Areas (8 Words/Computer) 



60306500 E 



IM-3 



SYSTEM POINTER AREA 



59 


47 


41 


23 




Page Length 


Standard Buffer Length 


(Reserved) 




Current Number of 
Empty Pages 


Index into 
Empty Page Stack 




(Reserved) 
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FLAW TABLE 



59 



35 



23 



17 



Maximum Number 
of Flaws 



Current Number 
of Flaws 



Address of 
Flawed Page 



IP.EFLW+1 



SYSTEM PAGE 



59 


. ■ ■ ' '.■'■ 


*7 


It 


23 





Subpage 
Length 


i Previous System 
Page Address 


Next System 
Page Address 


Maximum Number 
of Subpages 


Current Number 
of Empty Subpages 


First Empty 
Subpage Address 















System 

Page 

Header 



(Subpage Format Shown in CMR Section) 
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SEGMENTS IN AN ECS SYSTEM 



SEGMENT 



DECK 



AORB 


SPM3 


BBJ 


MMGR 


CACT 


ECLINK 


CALLDAM 


SPM5 


CBM 


ECS 


C8MEND 


ECS 


CCP 


MMGR 


CHKSPAC 


RACDAC 


CLRCEM 


ECS 


CMDATA 


ECDATA 


CMRDIR 


CMRDIR 


CONTDAM 


SPM5 


CPCIO 


CPCIO 


CPECSM 


CPSM 


CPMTR 


CPMTR 


CPPXT 


ECS 


CPSCH 


MMGR 


CPSM 


CPSM 


CPSPM 


SPM1 


CPSS 


RESCH 


CPSSF 


SCPT 


CPUST 


CPMTR 


CP4ES 


CPCIO 


CSBS 


ECLINK 


CSWP 


MMGR 


OAC 


RACDAC 


OEAL 


ECS 


DJO 


MMGR 


ORVR 


ECLINK 


DRVRS 


ECLINK 


DftVS 


ECLINK 


ORVSS 


ECLINK 


ECPARTY 


ECLINK 


ECSDSO 


ECS 


ECSSWAP 


ECSSWAP 


ECSUB 


ECSSUB 


EL INK 


ECLINK 


EVICTCH 


SPM4 


EVICTOW 


SPM4 


EX800T 


RESCH 


EXRBT 


SPM4 


ERPEREC 


ECSSUB 


ERS 


MMGR 


FILLSTK 


ECSSUB 


FLSHBUF 


ECS 


FLUSHST 


ECSSUB 


GETDESC 


ECS 



PURPOSE 

add record blocks onto rbt 

bring in a batch job 

subroutine to change job activity count 

initiate rbr update from dam 

circular buffer manager 

circular buffer manager termination 

clean up control point area 

subroutine to check if ecs space is available 

clear cem working flag 

common data areas 

directs ldcmr in assigning segment residence 

continue dam processing 

central processor i/o control 

storage move <ecs> 

identify reason for monitor mode execution 

ecs executive* central resident routines 

main loop - memory manager 

storage move (cm) 

stack processor manager 

calculate system seconds - ex.ss 

ex.ssf function processor 

on/off cpu 

enter stack request 

subroutine to check ecs link buffer space 

call 1si/1so ppu swappers 

deallocate ecs overlay pages 

deallocate prus of data in ecs buffer 

subroutine to delink job descriptor 

ecslink receive driver 

subroutines for ecs link receive driver 

ecs send driver 

subroutines for ecs send driver 

ecs link parity error processor 

dso ecs commands cp helper 

ecs - job swapper interface 

ecs executive subroutines 

ecs link restart 

evict on user sets 

evict on write 

start ecs system 

pru conversion. m. ice function 

ecs read parity error recovery 

empty scheduler request stack 

subroutine to fill cm ecs page stack 

flush ecs buffer to disk 

subroutine to flush cm ecs page stack 

subroutine to read an ecs pru descriptor 
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SEGMENT 



DECK 



PURPOSE 



GETPRU ECS GET A PRU 

GETPRE RACOAC SUBROUTINE TO GET PREALLOCATED PAGE 

GETRANO ECS ECS READ DRIVER 

GETSU8P ECS SUBROUTINE TO GET AN ECS SUBPAGE 

ILINK ECLINK INITIALIZE ECS LINK 

INDEX SPM* SUBROUTINE TO CONVERT PRU INDEX TO R8T CHAIN FORMAT 

1N1T LINKCMR INITIALIZE SYSTEM 

LINK RESCH SUBROUTINE TO LINK A JOB INTO ACTIVE CTL PT RING 

LINKDST SPM3 SUBROUTINE TO LINK STACK REQUEST TO DST CHAIN 

LINKVAR ECLINK SUBROUTINE FOR ECS LINK VARIABLES INITIATION 

OPECLO CPCIO CPCIO OPEN/CLOSE EXECUTIVE 

OPM MMGR OPTIMIZE FL PRIORITY MAP 

PACKAGE RESCH SUBROUTINE TO UPDATE RA/FL 

PLBCNT ECS CONTINUE LOADING PP OVERLAY FROM ECS 

PLBECS ECS LOAD PP OVERLAY FROM ECS 

PLBERR ECS ERROR WHILE LOADING PP OVERLAY FROM ECS 

PLBREL ECS RELEASE BUFFER AFTER LOADING PP FROM ECS 

PPLIB. RESCH SEARCH PP LIBRARY AND LOAD PP OVERLAY 

PREALLO ECS PREALLOCATE ECS 

PROCERR ECLINK PROCESS DRIVER DETECTED ERRORS 

RAC RACDAC REQUEST PREALLOCATED ECS SPACE 

RAGET ECLINK SUBROUTINE TO FETCH EXCHANGE PACKAGE RA 

RAPLUSI RAP! IDENTIFICATION OF RA*1 CALLS 

RBTRB SPM5 SUBROUTINE TO CONVERT RBT CHAIN FORMAT TO PRU INDEX 

RCM CPMTR REQUEST CHANNEL 

RCH3 CPMTR CHANNEL REQUEST SUBROUTINE 

READ CPCIO CPCIO READ EXECUTIVE 

READDAM SPM5 PREPARE STACK REQUEST TO READ DAM 

RELECS ECS RELEASE ECS BUFFER 

RELPRE RACDAC SUBROUTINE TO RELEASE PREALLOCATED ECS PAGES 

RELSB ECS SUBROUTINE TO RELEASE SYSTEM BUFFER 

RELSUBP ECS SUBROUTINE TO RELEASE AN ECS SUBPAGE 

REQE8UF ECS REQUEST ECS BUFFER 

RESCH RESCH SELECT THE NEXT JOB FOR CPU EXECUTION 

RESET CPCIO SUBROUTINE TO LOGICALLY REWIND ECS BUFFER 

REWIND CPCIO CPCIO REWIND EXECUTIVE 

RMRLST CPCIO SUBROUTINE TO PROCESS PRU INDEX LIST FOR READLS 

RTAFL SPM3 SUBROUTINE TO REQUEST OR TERMINATE FIELD ACCESS 

SCADDT SPM4 SUBROUTINE TO SCAN ODT AND RBR HEADERS 

SCHRES MMGR SCHEDULER CM RESIDENT SUBROUTINES 

SEGLINK LINKCMR SEGMENT CALL/GOTO LINKAGE PROCESSOR 

SEGPAR LINKCMR ECS SEGMENT PARITY ERROR PROCESSOR 

SETST CPMTR CPU STATUS BIT MANIPULATIONS 

SFCP ECLINK SUBROUTINE TO SET FILE COMPLETE 

SKIPS CPCIO CPCOI SKIP BACKWARD EXECUTIVE 

SKIPF CPCIO CPCIO SKIP FORWARO EXECUTIVE 

SPMBKSP SPM3 BACKSPACE RELATED FUNCTIONS 

SPRBMGR SPM4 RECORD BLOCK MANAGER 

SSCSEG SCPT SYSTEM CONTROL POINT CALLS FROM USER CONTROL POINTS 
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SEGMENT DECK PURPOSE 



SSFSEG SCPT SUBSYSTEM FUNCTION PROCESSOR 

SREQ ECLINK SUBROUTINE TO HANDLE ECS LINK SUBCHAMNEL REQUESTS 

SSFS2 SCPT SECONDARY SET OF SUBSYSTEM FUNCTIONS 

STOPRU ECS STORE PRU 

STORE ECS MOVE DATA FROM USERS CM BUFFER TO ECS BUFFER 

SWCLEAN ECS CLEAN UP AFTER PARITY ON ECS SWAP FILE 

SYSPROG RESCH CHECK STATUS OF A USER MODE SYSTEM PROGRAM 

TOVSH SPM5 SUBROUTINE TO TEST OVERFLOW OF A SHARED DEVICE 

TTS MMGR TRY TO SCHE'uDLE 

TRAUTEB ECS TERMINATE AUTOMATIC ECS BUFFER ALLOCATION 

TIMSEG RAP1 PROCESS TIM CALLS 

UPM MMGR UPDATE FL PRIORITY MAP 

USERMOD CPMTR INITIATES EXECUTION OF USER MODE SYSTEM PROGRAMS 

USERR RESCH RESIDENT USER MODE ENTRY/EXIT ROUTINES 

WRITE CPCIO CPCIO WRITE EXECUTIVE 

XJRSEG RAP1 PROCESS XJR OR SAC CALLS 

XSPM SPM2 EXTENSION OF STACK PROCESSOR MANAGER 



• H-4-8 60306500 K 



INDEX 



Abnormal job termination 

KILL, RERUN 7-18 
Accessing device sets 

MOUNT control card 64 
Accounting 

Permanent files 6-37 
ACQUIRE macro 

Functions GET, PEEK, COUNT 4-9 

Searching local files 4-9 
ADDSET control card 6-41 
Allocatable device 

Area II-4-2 

I/O: READC, READLS, WRITEC 5-23 

Tables related to file processing 4-29 
Allocation 

CM 1-2; 2-1; 3-22 

ECS 1-2 

Overview of device allocation map (DAM) II-3-20 

PFC allocation matrix (PAM) II-3-26 
ALTER 

ACQUIRE macro function 4-9 
ALTER macro functions 6-13 
APF 

Permanent file entries 6-33 

Table II-1-60 
Archive permanent files 6-24 
Area table II-1-83 
ASCII character set A-4 

Punched card codes 

EBCDIC translation A-5 
ASCII translation A-6 
Assignment 

Automatic tape drive 4-25 

Permanent file to RMS devices 6-1 

PP 1-1; 3-27 
ATTACH 

Macro function 6-11 

Permanent files, see APF 
Attached permanent file table II-1-60 
Attribute 

Address public sets by set attribute 6-46 

Attribute (see RMS set terminology) 4-27 



AUDIT 

Macro to obtain permanent files status 

Permanent file utility routine 6-17 
Automatic 

Generate FDB using control card 6-5 

Recall 2-6 
Auxiliary user table II-1-107 



6-29 



Bit 



1-2 



Byte and bit number 
Block 

Block format (DA file) II-3-27 

I block header II-3-27 

Index block format (IS file) 113-28 

Record block reservation table II-1-62 

Record block table entry II-1-114 
Breakpoint table II- 1-81 
Buffer 

CEFAP buffer area II-1-87 

Dayfile FET and buffer area II-1-74 

Default size for deadstart 1-3 

INTERCOM pointer and buffer area II-1-96 

SCB (system circular buffer) II-1-92 

Sizes 4-19 

Sub-page buffer H-l-90 
BULLUP 

Create and update system bulletin file 

File and data statements 9-1 

Interface with INTERCOM 94 

Reduce systems bulletin file 94 
Byte and bit number 1-2 



CALLSS macro 2-20 
Carriage control II-1-109 
CATALOG macro functions 6-9 
CEFAP buffer area II-1-87 
Central memory, see CM 

Resident, see CMR 
CERFILE 

System CERFILE error file 4-2 



9-3 
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Chain, PP 3-27 
Channel coupler entry H-l-36 
Channel reservations 3-14 
Channel status table (CST) II-1-15 
Character set 

ASCII A-4 

EDITLIB 8-3 

Standard A-3,7 
CIO 

Circular buffering 5-4 

Codes 5-3; II-2-4 

Concepts and codes 5-1 

Functions 5-6 

Use of circular buffer 5-4 
Circular input/output, see CIO 
CM allocation to control point 2-1; 3-22 
CM resident library format H-l-94 
CMR 2-8; II-l-l 

Areas summary 2-9 

Library directory II-1-93 

Loader, see LDCMR 10-1 

Pointer area II- 1-2 

Segmentation for ECS system 2-13 

Table 2-10 

Table function summary 2-11 
Codes 

CIO codes 5-3; II-2-4 

CIO concepts and codes 5-1 

Device codes II-1-37 

Disposition code values II-1-52 

FET codes II-2-8 

Punched card codes 

ASCII translation A-6 
EBCDIC translation A-5 

Stack processor order codes II-1-61 
Common area H-4-2.1 
Communication word II- 1-23 
Console display, see DSD 
Control 

Job control area II-1-76 
Control Card 

Automatic generation of FDB 6-5 

Buffer 7-13 

LDCMR parameters 10-1 

Processing flowchart 7-14 

Processing terminated by EXIT 7-15 
Control point 

CM allocation to control point 2-1 ; 3-22 

Control point area II-l-l 7 



Conversion table 

Hexadecimal-octal A-8 
COUNT 

ACQUIRE macro function 4-9 
CP 

Monitor 3-12 

RA+ 1 requests; CP-system communication 24 
Create device sets 641 
Creating and updating system bulletin file, 

BULLUP 9-3 
CST channel status table II-l-l 5 



D 

PP direct cells, D. symbols 3-1,3 
Dayfile 

Dayfile FET and buffer area H-l-74 

System dayfile 4-1; 7-17 
DDP entry II-1-36 

DDT (dismountable device table) H-l-66 
Deadstart 

Creating using EDITLIB 8-1 

Default buffer size 1-3 

Loading operating system 14 

PP usage in deadstart load 1-6 

Tape records and overlays 1-7 
Delay count 2-6 
DELSET control card 

Deleting device sets 5-39; 6-39 
Descriptors, record II-1-90 
Device 

Activity table entry H-l-59 

Allocation map (DAM) II-3-20 

Codes II-1-37 

Permanent file set label II-3-13 

Tables summarized 4-21 
Device sets 4-27 

Accessing sets, MOUNT 644 

Creating and processing 6-37 

Creating sets using ADDSET 641 

Deleting sets using DELSET 642 

Directing files to specific sets, REQUEST 645 

Disassociating sets, DSMOUNT 645 

Implicit reference to sets, SETNAME 646 

I/O processing 5-35 

Reconstructing tables, RECOVER 642 

Shared device sets 4-28 
Device status table II- 1-63 

Multiple access entries II- 1-63 
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Diagnostics 

ROUTE macro 4-4 
Direct access area II-4-2 
Direct cells 

PP, D. symbols 3-1,3 
Directive 

EDITLIB directives 8-12 

EDITLIB parameters 8-9 

Used with DUMPF utility 6-18 
Directory 

CMR library directory II-1-93 
Dismoun table device table (DDT) II-1-66 
Dismountable pack processing, I/O detail 5-35 
Display console, see DSD 

Entry II-1-36 
Disposition code values II-1-52 
DSD/INTERCOM communication through station, 

MSG table II-2-28 
DSMOUNT 

Disassociating device sets 5-39; 6-45 
Dual access 

Device entry H-l-59 
Dummy entry for dual access device II- 1-59 
Dump (System Dynamic Dump) 11-1 
DUMPF utility 6-18 

Clearing permanent files 6-18 

Directives used with utility 6-20 

S tape usage required 6-18 



EBCDIC with punched card codes and ASCII 

translation A-6 
ECS 

Allocation 1-2 

Buffering of RMS files 540 

CMR segmentation for ECS system 2-13 

Error recovery 2-18 

Format II-4-1 

Label II-4-1 

Paging 1-3 

Partitioning formats 114-2,2.1 

Overall ECS format II4-1 

Segments II4-6 
EDITLIB 

Basic usage of system EDITLIB 8-1 

Deadstart creation 8-2 
Empty page stack II-1-89 
ENDSEG 

Macros for CMR segmentation 2-14 



Entry formats 

EPNT, ERT, PNUT, PNT II-1-95 
Entry point names II-2-7 
Entry table II-1-84 
EPNT entry format II-1-95 
Equipment status table (EST) II-1-35 
Error 

Codes, reprieve processing 7-21 

Conditions detected by stack processor 5-32 

ECS error recovery 2-18 

RMS hardware error 5-35 

System CERFILE error file 4-2 
Error file 

CEFAP buffer area analyzer program H-l-87 
ERT entry format II-1-95 
EST (equipment status table) H-l-35 
Exchange jumps 

Exchange package II-1-16 

Scheduler request stack in system exchange 
package area 7-6 

System job exchange package area II-1-21 
EXIT card processing terminated 7-15 
EXTEND macro functions 6-14 
Extended core storage, see ECS 



FDB 

Automatic generation 6-5 

Table II-2-20 
FET 

Codes H-2-8 

Dayfile FET and buffer area II-1-74 

Table II-2-3 
Field access flag 3-11 
Field length, see FL 
Field length override 8-12 
File 

Definition block II-2-20 

File environment, table, see FET 

File information table, see FIT 

Swap file format II-3-35 
File name table (FNT) II-1-39 
Files 

EDITLIB 8-7 

LDCMR 104 
FIT table II-2-10 
FL 

Allocated storage definition 2-3 
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Flaws 

Device relabeling 6-40 

Flaw table II-4-5 
FLO 8-12 

FNT (file name table) II-1-39 
FSTT 

AK file II-3-33 

DA file II-3-31 

IS file II-3-29 



GET 

ACQUIRE macro function 4-9 
GETPF macro function 6-13 
GOTO macros for CMR segmentation 



2-14 



Header 

I block header II-3-27 

W record header II-3-27 
Hexadecimal-octal conversion table A-8 
Host ID local mainframe 6-4; 7-23 



ID table II-1-71 

Index block format (IS file) II-3-28 

Input queue 4-3 

Interactive graphics user table II-l-l 13 

INTERCOM 4 

Auxiliary user table II-1-107 

Buffer area II-1-102 

BULLUP interface, SYSBULL 9-4 

Driver communication area II-l-l 00 

Input/output interface with JANUS 7-3 

Multiplexer table, subtables II-1-55 

Pointer and buffer area II- 1-96 

User table II-1-103 
Interlock LDCMR 10-5 
Inter-computer area II-4-3 
I/O 

Allocatable device I/O; READC, READLS, 
WRITEC 5-23 

Device set processing 5-35 

Dismountable pack processing, I/O detail 5-35 

ROUTE macro used in queueing 4-4 

Tables summarized 4-17 



JANUS interfaces 7-3 

Input/output interface with INTERCOM 7-3 
JDT 7-10 

Swap job information 2-3; 7-8 

Table entry II- 1-77 
Job 

Control area II- 1-76 

Descriptor number 2-3 

Descriptor table II-1-77 

Flow 7-1 

Function of VSN card in prescheduling 4-25 

Load from tape, TLOAD routine 7-2 

Origin II-2-2 

Post-processing utilities 7-19 

Roll-out 7-7 

Scheduling execution through class assignment in 
job control area 7-9 

Scheduling queues 7-10 

Termination, abnormal KILL, RERUN 7-18 

Termination, normal 7-15 



KILL, abnormal job termination 7-18 



Label 

LABELMS 6-37 

Permanent file set device II-3-13 
LDCMR 

Control card parameters 10-1 

Files 104 

Interlock 10-5 

Overview 10-1 

Reserved names 10-6 
Library 

CM resident library format II-1-94 

CMR library directory II-1-93 
Library name 

Table entry 8-25; H-l-93 

Table interfaces 8-32 
LID (logical identifiers) 7-23 
Link 

ID linked mainframe 64; 7-23 

Identification values II- 1-54 

Staging, local and link 64 
List core-image dump utility 11-2 
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list system dynamic dump file 11-2 

LISTCID utility 11-2 

Load 

Job load from tape, TLOAD routine 7-2 

PP usage in deadstart load 1-6 
LOADPF utility 6-17,23 
Loading permanent files from tape 6-23 
Local 

Host ID local mainframe 64; 7-23 

Staging, local and link 6-4 
Local files 4-2 

ACQUIRE macro usage in searching local files 

Local file names II-2-5 
Logical file name 

Logical identifiers (LID) 7-23 
Logical Flaw Table II-3-22 



M.xx monitor functions 3-16,23 
Macros 

CMR segmentation 2-14 

Permanent file functions, parameters 6-1 
Magnetic tape entry 11-1-35 
Mailbox II-1-70 
Mainframe 

Host ID local 64; 7-23 

Link ID linked .64; 7,23 

User assignment of system files to mainframe 
B 64 
Mask, reprieve code 7-19 : 
Monitor 

CP processing 3-14 

Functions 3-16; 11-1-33 

PP processing 3-22 

Structure 3-1 5 
MOUNT control card 6-44 
Mounted set table (MST) II- 1-65 
MSG table 

DSD/INTERCOM communication through 
station II-2-28 
MST (mounted set table) II-1-65 
MTR, see monitor 
Multiplexer entry II-1-36 
Multiuser job table. 11-1-112 



Normal job termination 7-15 
Normal reprieve processing 7-21,22 
Null function 3-20 



Output queue 4-3 
Overcommitment of tape drives 



4-26 



Name reservations, PP 
NFL 8-12 
Nominal field length 



II-1-24 



8-12 



Pack queue 7-17 
Page 
4-9 Empty page stack II-1-89 
Paging 

ECS paging 1-3 
Parameters 

Permanent file functions 6-2 
Password 

Public 6-5,35 

Universal 64,35 
PEEK 

ACQUIRE macro function 4-10 
Periodic recall 2-6 
Peripheral processor, see PP 

Peripheral job table II-1-73 
PERM macro 6-16 
Permanent files 7-15 

APF entries 7-15 

Assignment to RMS devices 6-1 

AUDIT macro to obtain status 6-29 

Automatic archive feature 6-24 

Catalog, see PFC 

Clear files using DUMPF 6-18 

Copy or transfer files, TRANSPF 6-25 

Directory .U-3-1,2 

Functions, parameters, and macros 6-1 

Files interlocks 6-33 

Loading files from tapes, LOADPF 6-23 

Set device label II-3-13 

Utility routines 6-17 
Permission, universal 64,35 
PFC 

Allocation matrix (PAM) II-3-26 

Entry II-3-6 

Overview II-3-5 
PFD 

Entry II-3-2 

Overview II-3-1 

Usage 6-33 
PFL 8-12 
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Physical flaw table II-3-22 
PNT 

Entry format II-1-95 

PP program name table entry II-1-94 
PNUT entry format IM-95 
Pointer 

CMR pointer area II- 1-2 

INTERCOM pointer and buffer area II-1-96 
PP 

Assignment 1-1; 3-27 

Chain 3-27 

Communication area II-1-22 

Communication register 34 

Communication with CP monitor 2-5 

Direct cells, D. symbols 3-1,3 

Job queue 3-29 

PNT II-1-93 

Program name reservations H-l-24 

Program name table entry 8-28; H-l-94 

Resident, R. functions 3-5 

Status words II-1-16 

Usage in deadstart load 1-6 
PPLIB 3-5 
Program name 

PP PNT entry H-l-94 

PP reservations II- 1-24 

PP table entry 8-28 
Public password 6-5,35 
PURGE macro functions 6-15 



Queue 

Definitions and processing 
Files 4-3 



4-3 



R, PP resident functions .3-5 
RA 

RA communication area II-2-1 

RA used in allocated storage definition 2-3 

RA+ 1 requests, CP-system communication 2-4 
READC 

Allocatable device I/O 5-23 
READLS 

Allocatable device I/O 5-24 
Recall 

Automatic 2-6 

Periodic 2-6 



Record 

Block reservation table 4-32; II-1-62 

Block table entry 4-32; II-1-114 

Descriptors II-1-90 

W record header II-3-27 
RECOVER control card 

Reconstruct device sets tables 6-42 
Recovery 

ECS error recovery 2-18 
RECOVR macro 7-21 
Reference address, see RA 
Register 

PP communication register 34 
RENAME macro functions 6-13 
REPRIEVE macro 7-19 
Reprieve processing 7-19 

Error codes 7-19 

Mask 7-19 
REQ function parameter list II-2-22 
Request scheduling table II-1-62 
Request stack entry II- 1-61 
RERUN 7-18 

Reserved name LDCMR 10-6 
Resident 

CM resident library format II-1-94 

PP resident, R. functions 3-5 
Resource scheduling conflicts 4-26 
RMS 

ECS buffering of RMS files 540 

Hardware error 5-35 

Permanent file assignment to RMS devices 6-1 

Set terminology 4-27 

System circular buffer (SCB) II-1-92 

Tables 4-29,32 
Roll-out job 7-7 
Rotating mass storage, see RMS 
ROUTE 

Macro 44 

Macro diagnostics 4-7 
RPV program 7-19 



SCB II-1-92 

Scheduler 

Integrated scheduler 74,5 
Performance table (SCHPT) II-1-75 
Request stack in system exchange package 
area 7-6 
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Scheduling 

Job scheduling queues 7-10 

Scheduling execution through class assignment in 
job control area 7-9 
SCP 2-19 
SEGDEF 

Macro for CMR segmentation 2-14 
Segment table II- 1-8 5 
Segmentation 

CMR segmentation for ECS system 2-13; II-4-6 

Macros for CMR segmentation 2-14 
Sequencer table II- 1-64 
Set 

RMS set terminology 4-27 
Set member table (mass storage) II-3-18 
SETNAME 

Implicit reference to device sets 6-46 
Spot name table (SNT) II-2-26 
Stack processor 

Empty page stack II- 1-89 

Error conditions detected 5-33 

Order codes II- 1-61 

Processing request 5-27 

Request stack entry II-1-61 

Scheduler request stack in system exchange 
package area 7-6 

Table usage 5-32 
Staging, local and link 6-4 
Standard character set A-3,7 
Status 

AUDIT macro obtains status of permanent files 
6-29 

PP status words II- 1-1 6 
Storage move 2-3 
Subchannel table (SCHT) II-2-24 
Subdirectory flag II-3-2 
Subpage buffer II-1-90 
Swap 

File format II-3-35 

Job information in JDT 2-3; 7-7 
Syntax, EDITLIB 8-4 
SYSBULL 

BULLUP interface with INTERCOM 9-4 
Systems bulletin file 

Reduce file, BULLUP 94 
System bulletin utility, BULLUP 9-1 

Create and update system bulletin file, 
BULLUP 9-3 
System circular buffer II- 1-92 



System control point 2-19 

System dynamic dump 11-1 

System files, see dayfile and CERFILE 

System job exchange package area II-1-21 

System page II-4-5 

System pointer area 1144 



Tables 

Related to file processing on RMS devices 4-29,32 

Stack processor table usage 5-32 
Tapes 

Automatic tape drive assignment 4-25 

Job load from tape, TLOAD routine 7-2 

Overcommitment of tape drives 4-26 

Staging table II- 1-60 

Tapes table 2-1 1 ; 4-26.1 ; II-1-69 
TLOAD routine 

Job load from tape 7-2 
TRANSPF utility 6-17,25 



UCP 2-19 

Unit record equipment entry II- 1-3 5 

Universal password 6-4,35 

Universal permission 64,35 

User control point 2-19 

User table 

Auxiliary table H-l-107 

Driver words II-1-104 

High speed auxiliary user table II-l-lll 

IGS user table H-l-113 

Multiuser job table II-1-112 
Utility routines, permanent files 

AUDIT 6-29 

DUMPF 6-18 

LOADPF 6-23 

TRANSPF 6-25 



VERIFYJ Macro 4-16.3 

VSN card in job prescheduling 4-25 

VSNBUF, volume serial number buffer 



WRITEC 

Allocatable device I/O 5-26 



ZZZZZxx (Local File Names) II-2-5 



II-1-68 
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Local 

Staging r Local and Link 6-4 

Host ID Local Mainframe 6-4 7-23 
Local Files 

Local Files 4-2 

ACQUIRE Macro Usage in Searching Local Files 4-9 

Local Files ■» Names II-2-5 
Logical File Name 

Logical File Name 

Logical Identifiers, ( LID ) 7-23 



M.xx 

M.xx Monitor Functions 3-16, 3-25 

Macros 

Macros for CMR Segmentation; GOTO, SEGDEF, ENDSEG 2-14 
Permanent File Functions; Parameters and Macros 6-1 

Mailbox 

Mailbox II-1-70 

Mainframe 

Host ID Local Mainframe 6-4,7-23 

Link ID Linked Mainframe 6-4,7-23 

System Files that Reside at Mainframe-A 6-4 

User Assignment of System Files to Mainframe-B 6-4 

Monitor 

CP Monitor Processing 3-14 
PP Monitor Processing 3-23 
Monitor Structure 3-15 

Monitor Functions 3-16, II-1-34 
MOUNT 

Accessing Device Sets Using MOUNT Control Card 6-44 
Mounted Set Table 

Mounted Set Table ( MST ) II-1-65.1 



MSG Table 

DSD/INTERCOM Communication through Station - MSG Table II-2-28 
MST 

Mounted Set Table ( MST ) II -1-65.1 
MTR 

MTR; Also See Monitor 



Name 

PP Program Name Reserved 3-11 



Normal 

Normal Job- Termination 7-15 
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Overcommitment 

Overcommitment of Tape Drives 4-26 

Pack 

Pack Queue 7-17 

Page 

Empty Page Stack II-1-89 
Pag ing 

ECS Paging 1-3 
Parameters 

Permanent- File Functions; Parameters and Macros 6-1 
PEEK 

ACQUIRE Macro Functions GET, PEEK, COUNT 4-9 
Periodic 

Periodic Recall 2-6 
Peripheral Processor 

Peripheral Processor; See PP 

Peripheral Job Table II-1-74 
PERM 

PERM Macro - Description 6-16 
Permanent 

Permanent File Interlocks 6-33 

Permanent Fxle Assignment to RMS Devices 6-1 

Permanent File Functions; Parameters and Macros 6-1 

Permanent File Utility Routines: DUMPF, LOADF, TRANSPF, AUDIT 6-17 

Automatic Archive Feature of Permanent Files 6-24 

Clearing Permanent Files Using DUMPF 6-18 

Loading Permanent Files from Tapes Using LOADPF 6-19 

Copying or Transferring Permanent Files Using TRANSF 6-20 

Use of AUDIT Macro to Obtain Status of Permanent Files 6-30 

Permanent File Creation During System Deadstart Load 6-35 

APF Entries for Permanent Files 7-16 

Permanent File Catalog; See PFC 

Permanent File Set Device Label II-3-13 
PFC 

PFC Entry II-3-6 

PFC Overflow II-3-5 

PFC Allocation Matrix (PAM) II-3-26 
PFD 

PFD Usage 6-35 

PFD Overview II-3-1 

PFD Entry II -3 -2 
PFMOVE 

Permanent File Utility Routines: DUMPF, LOADF, TRANSPF, AUDIT 6-17 

Physical Flow Table 

Physical Flow Table II-3-22 
PNT 

PP Program Name Table Entry ( PNT ) II -1-94 

EPNT, ERT, PNUT, PNT Entry Format II-1-95 
PNUT 

EPNT, ERT, PNUT, PNT Entry Format II -1-95 
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Pointer 

CMR Pointer Area II -1-2 

INTERCOM Pointer and Buffer Area II-1-96 



PP 



PP Assignment 1-1 

PP Usage in Deadstart Load 1-6 

PP Communication with CP Monitor 2-5 

PP Direct Cells; D. Symbols 3-2 

PP Communication Register 3-4 

PP Resident; R. Functions 3-5 

PP Monitor Function Codes and Mnemonics 3-5 

PP Program Name Table Entry 8-72 

PP Status Words II -1-16 

PP Communication Area II -1-2 2 

PP Program Name Reservations II-1-24 

PP Program Name Table Entry ( PNT ) II-1-94 



Program- Name Table 

PP Program Name Table Entry 8-72 

PP Program Name- Reservations II-1-24 

PP Program- Name- Table Entry ( PNT ) II-1-94 



PURGE 

PURGE Macro - Functions Described 6-15 



Queue 

Queue Definitions and Processing 4-3 

Control Card Processed in Job Advancing Queue 7-12, 7-13, 7-15 
Queues 

Job Scheduling Queues 7-11 

R 

PP Resident; R. Functions 3-5 
RA 

RA Used in Allocated Storage Definition 2-3 

RA + 1 Requests; CP / SCOPE Communication 2-4 

RA Communication Area II -2-1 
READC 

Allocatable Device I/O; READC, READLS, WRITEC 5-23 
READLS 

Allocatable Device I/O; READC, READLS, WRITEC 5-23 
Recall 

Automatic Recall 2-6 

Periodic Recall 2-6 
Record 

Record Block Reservation Table 4-32, II-1-62 

Record Descriptors II-1-90 

Record Block Table Entry 4-32, II-1-114 

W Record Header II -3 -27 
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RECOVER 

Reconstructing Tables of Device Sets Using RECOVER Control Card 6-42 
Recovery 

ECS Error Recovery 2-18 
RECOVR 

User Call to RECOVR Generates Call to RPV 7-19,7-21 
Reference Address 

Reference Address; See RA , 
Register 

PP Communication Register 3-4 
RENAME 

RENAME Macro - Functions Described 6-13 
REQ 

REQ Function Parameter List II-2-22 
RERUN 

Abnormal Job-Termination; KILL, RERUN 7-18 
Reserved 

PP Program Name Reserved 3-11 
Reserved Name 

LDCMR Reserved Name 10-6 
Resident 

CM Resident Library Format II-1-94 
Resident 

PP Resident; R. Functions 3-5 
RMS 

Set Terminology 4-27 

RMS Recording Technique 4-31 

RMS Tables Summarized 4-29 

RMS Hardware Error 5-35 

ECS Buffering of RMS Files 5-40 

Permanent File Assignment to RMS Devices 6-1 

System Circular Buffer (SCB) II -1-92 

Roll -Out 

Job Roll-Out 7-7 
Rotating Mass Storage 

Rotating Mass Storage; See RMS 4-27 
ROUTE 

Use of ROUTE Macro in I/O Queueing 4-2 

ROUTE Macro 4-4 

ROUTE Macro Diagnostics 4-7 
RPV 

User Call to RECOVR Generates Call to RPV 7-19, 7-21 

Scheduler 

Integrated Scheduler 7-4, 7-5 

Scheduler Request Stack in System Exchange Package Area - Illustration 7-6 

Scheduler Performance Table (SCHPT) II-1-75 
Scheduling 

Scheduling of Execution through Class Assignment in Job Control Area 7-9 

Job Scheduling Queues 7-11 
SEGDEF 

Macros for CMR Segmentation; GOTO, SEGDEF, ENDSEG 2-14 
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Segment 

Segment Table II-1-85 

Segment in an ECS System II-1-86 
Segmentation 

CMR Segmentation for ECS System 2-13 

Macros for CMR Segmentation; GOTO, SEGDEF; "ENDSEG 2-14 
Sequencer Table 

Sequencer Table II -1-65 

Set 

RMS Set Terminology 4-27 

SETNAME 

Implicitly Referencing Device Sets Using SETNAME Control Card 6-46 
Set Member Table 

Set Member Table (Mass Storage) II-3-18 
Spot Name Table 

Spot Name Table (SNT) II-2-26 
Stack 

Processing Stack Request 5-27 

Stack Processor Order Codes 5-29, II-1-61 

Stack Processor Table Usage 5-31 

Error Conditions Detected by the Stack Processor 5-33 

Scheduler Request Stack in System Exchange Package Area - Illustration 7-6 
Request Stack Entry II-1-61 

Empty Page Stack II-1-89 
Staging 

Staging, Local and Link 6-4 
Status 

Use of AUDIT Macro to Obtain Status of Permanent Piles 6-30 

PP Status Words II-1-16 

Dual Access Status Word Pair II-1-63 
Storage Move 

Storage Move 2-3 
Subchannel 

Subchannel Table (SCHT) II-2-24 
Swap 

Swap Job Information Contained in JDT 2-3, 7-8 

Swap File Format II-3-35 
Syntax 

EDITLIB Syntax 8-4 
SYSBULL 

BULLUP Interface with INTERCOM; SYSBULL 9-5 
Systems Bulletin File 

Reducing a Systems Bulletin File Using BULLUP 9-4 
System Bulletin Utility 

System Bulletin Utility; See BULLUP 9-1 

Creating and Updating a System Bulletin File Using BULLUP 9-3 

System Control Point 2-19 

System Files 

System Files; See Day file and CERFILE 
System Page 

System Page I I -4 -5 
System Pointer Area 

System Pointer- Area II-4-4 
S Tape 

S Tape Usage Required with DUMPF Utility 6-17, 6-18 
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Table 

Stack Processor Table Usage 5-31 
Tables 

Tables Related to File Processing on RMS Devices 4-27 
Tape 

Automatic Tape Drive Assignment 4-25 

Overcommitment of Tape Drives 4-26 

Job Load from Tape Using TLOAD Routine 7-2 
Tapes Table 

Tapes Table II-1-69 
Tape Staging Table 

Tape Staging Table II -1-60 
TLOAD 

Job Load from Tape Using TLOAD Routine 7-2 
TRANS F 

Copying or Transferring Permanent Files Using TRANSF 6-20 
TRANSPF 

Permanent File Utility Routines: DUMPF, LOADF, TRANSPF, AUDIT, 6-17 



User 

User Table Driver Words II -1-103 

Auxiliary User Table II-1-107 

High Speed Auxiliary User Table II-l-lll 

Multi User Job Table II-1-112 

IGS User Table II -1-113 



Utility 

Permanent File Utility Routines: DUMPF, LOADF, TRANSPF, AUDIT 6-17 
Directives Used with DUMPF Utility 6-18 



VSN 

Function of VSN Card in Job Prescheduling 4-25 
VSNBUF 

VSNBUF - Volume Serial Number Buffer II-1-68 



WRITEC 

Allocatable Device I/O; READC, READLS, WRITEC 5-23 
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